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Advance Praise for Head First Programming 


“Head First Programming does a great job teaching programming using an iterative process. Add a little, 
explain a little, make the program a little better. This is how programming works in the real world 
and Head First Programming makes use of that in a teaching forum. I recommend this book to anyone 
who wants to start dabbling in programming but doesn’t know where to start. I’d also recommend this 
book to anyone not necessarily new to programming, but curious about Python. It’s a great intro to 
programming in general and programming Python specifically. 5, 

一 Jeremy Jones, Coauthor of Python for Unix and Linux System Administration 


“David Griffiths and Paul Barry have crafted the latest gem in the Head First series. Do you use a 
computer, but are tired of always using someone else’s software? Is there something you wish your 
computer would do but wasn’t programmed for? In Head First Programming, you’ll learn how to write 
code and make your computer do things your way.’’ 

— Bill Mietelski, Software Engineer 


“Head First Programming provides a unique approach to a complex subject. The early chapters make 
excellent use of metaphors to introduce basic programming concepts used as a foundation for the rest 
of the book. This book has everything, from web development to graphical user interfaces and game 
programming.” 

— Doug Hellmann, Senior Software Engineer, Racemi 


“A good introduction to programming using one of the best languages around, Head First Programming 
uses a unique combination of visuals, puzzles, and exercises to teach programming in a way that is 
approachable and fun.” 

— Ted Leung, Principal Software Engineer, Sun Microsystems 


Praise for other Head First books 


“Kathy and Bert’s Head First Java transforms the printed page into the closest thing to a GUI you’ve ever 
seen. In a wry, hip manner, the authors make learning Java an engaging ‘what’re they gonna do next?’ 
experience.” 

— Warren Keuffel, Software Development Magazine 


“Beyond the engaging style that drags you forward from know-nothing into exalted Java warrior status, Head 
First Java covers a huge amount of practical matters that other texts leave as the dreaded 'exercise for the 
reader.."’ It’s clever, wry, hip and practical — there aren’t a lot of textbooks that can make that claim and live 
up to it while also teaching you about object serialization and network launch protocols.” 

— Dr. Dan Russell, Director of User Sciences and Experience Research 
IBM Almaden Research Center (and teaches Artificial Intelligence at 
Stanford University) 


“It’s fast, irreverent, fun, and engaging. Be careful~you might actually learn something!” 

— Ken Arnold, former Senior Engineer at Sun Microsystems 

Coauthor (with James Gosling，creator of Java )， The Java Programming 
Language 


“I feel like a thousand pounds of books have just been lifted off of my head.” 

— Ward Cunningham, inventor of the Wiki and founder of the Hillside Group 

“Just the right tone for the geeked-out, casual-cool guru coder in all of us. The right reference for practi¬ 
cal development strategies — gets my brain going without having to slog through a bunch of tired, stale 
professor-speak.” 

— Travis Kalanick, Founder of Scour and Red Swoosh 
Member of the MIT TR100 


“There are books you buy, books you keep, books you keep on your desk, and thanks to O’Reilly and the 
Head First crew, there is the penultimate category, Head First books. They’re the ones that are dog-eared, 
mangled, and carried everywhere. Head First SQL is at the top of my stack. Heck, even the PDF I have 
for review is tattered and torn.” 

— Bill Sawyer, ATG Curriculum Manager, Oracle 


“This book’s admirable clarity, humor and substantial doses of clever make it the sort of book that helps 
even non-programmers think well about problem-solving.” 

— Cory Doctorow ， co-editor of Boing Boing 
Author, Down and Out in the Magic Kingdom 
and Someone Comes to Town, Someone Leaves Town 



Praise for other Head First books 


“I received the book yesterday and started to read it... and I couldn’t stop. This is definitely tres ‘cool.’ It 
is fun, but they cover a lot of ground and they are right to the point. I’m really impressed.” 

— Erich Gamma, IBM Distinguished Engineer, and co-author of Design Patterns 

“One of the funniest and smartest books on software design I’ve ever read.” 

— Aaron LaBerge, VP Technology ， ESPN.com 


“What used to be a long trial and error learning process has now been reduced neatly into an engaging 
paperback.” 

— Mike Davidson, CEO, News vine, Inc. 


“Elegant design is at the core of every chapter here, each concept conveyed with equal doses of 
pragmatism and wit.” 

— Ken Goldstein，Executive Vice President，Disney Online 

“I ▼ Head First HTML with CSS & XHTML — it teaches you everything you need to learn in a Tun coated’ 
format.’’ 


— Sally Applin, UI Designer and Artist 


“Usually when reading through a book or article on design patterns, I’d have to occasionally stick myself 
in the eye with something just to make sure I was paying attention. Not with this book. Odd as it may 
sound, this book makes learning about design patterns fun. 

u While other books on design patterns are saying 'Buehler... Buehler... Buehler ... 5 this book is on the 
float belting out 'Shake it up, baby!”’ 

— Eric Wuehler 


“I literally love this book. In fact, I kissed this book in front of my wife.” 


— Satish Kumar 



Other related books from O’Reilly 

Learning Python 
Programming Python 
Python Cookbook 


Other books in O’Reilly’s Head First series 

Head First Java™ 

Head First Object-Oriented Analysis and Design (OOA&D) 

Head First HTML with CSS and XHTML 

Head First Design Patterns 

Head First Data Analysis 

Head First Servlets and JSP 

Head First EJB 

Head First PMP 

Head First SQL 

Head First Software Development 

Head First JavaScript 

Head First Ajax 

Head First Physics 

Head First Statistics 

Head First Rails 

Head First PHP & MySQL 

Head First Algebra 

Head First Web Design 



Head First Programming 


o 


Wouldn*t it be dreamy if 
there were an introductory 
programming book that didiVt 
make you wish you were anywhere 
other than stuck in front of your 
computer writing code? I guess \Ys 
just a fantasy... 










u 








Paul Barry 
David Griffiths 


0，HEILLr 

Beijing • Cambridge • Famham • Koln • Sebastopol • Taipei • Tokyo 





Head First Programming 

by Paul Barry and David Griffiths 


Copyright © 2009 O’Reilly Media, Inc. All rights reserved. 

Printed in the United States of America. 

Published by O’Reilly Media, Inc., 1005 Gravenstein Highway North, Sebastopol, GA 95472. 

O’Reilly Media books may be purchased for educational, business, or sales promotional use. Online editions are 
also available for most titles {safari.oreilly.com). For more information, contact our corporate/institutional sales 
department: (800) 998-9938 or corporate@oreilly.com. 


Series Creators: 
Series Editor: 


Kathy Sierra, Bert Bates 
Brett D. McLaughlin 


Editor: 

Cover Designers: 
Production Editor: 


Brian Sawyer 
Steve Fehler 
Scott DeLugan 


Proofreader: 


Colleen Toporek 


Pciv*dv*c 


Indexer: 

Page Viewers: 


Angela Howard 

David: Dawn; Paul: Deirdre, Joseph, Aaron, and Aideen 





Printing History: 

November 2009: First Edition. 


The O’Reilly logo is a registered trademark of O 5 Re illy Media, Inc. The Head First series designations 
Head First Programming, and related trade dress are trademarks of O’Reilly Media, Inc. 


Da 條 （ Vrthou 七 〆 
y/Kom "the book 
y/ould Kavc 

bccir> -f 'misKcd) 


AidcCh f-Putuirc 
sihjev"/soh^y/iri-tc^) 


Paul 


dudes) 


Many of the designations used by manufacturers and sellers to distinguish their products are claimed as 
trademarks. Where those designations appear in this book, and O’Reilly Media, Inc., was aware of a trademark 
claim, the designations have been printed in caps or initial caps. 


While every precaution has been taken in the preparation of this book, the publisher and the authors assume no 
responsibility for errors or omissions, or for damages resulting from the use of the information contained herein. 

No surfers or snakes were harmed in the making of this book. 



This book uses RepKover T , M a durable and flexible lay-flat binding. 


ISBN: 978-0-596-80237-0 
[C] 





We dedicate this book to the first person who looked at a computer 
and then asked the question, “I wonder how I make it do this...?’’ 

And to those that made programming complex enough that people 
need a book like ours to learn it. 


David: To Dawn. The smartest person I know. 

Paul: This one’s dedicated to my father, Jim Barry, who, 25 years 
ago — when I needed a push — pushed me toward computing. That 
was a good push. 
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Paul ^ 


Paul Barry recently worked out that he has 
been programming for close to a quarter century, a 
fact that came as a bit of a shock. In that time, Paul 
has programmed in lots of different programming 
languages, lived and worked in two countries on two 
continents, got married, had three kids (well... his wife 
Deirdre actually had them, but Paul did play his part), 
completed a B.Sc. and M.Sc. in Computing, written 
two other books, written a bunch of technical articles 
for Linux Journal, and managed not to lose his hair... a 
situation that, sadly, may in fact be changing. 

When Paul first saw Head First HTML with CSS & 
XHTML, he loved it so much he knew immediately that 
the Head First approach would be a great way to teach 
programming. He is only too delighted, together with 
David, to create this book in an attempt to prove his 
hunch correct. 


Paul’s day job is working as a lecturer at The Institute 
of Technology, Carlow in Ireland. As part of the 
Department of Computing & Networking, Paul gets 
to spend his day exploring, learning, and teaching 
cool programming technologies, which is his idea of 
fun (and further proof that Paul probably needs to get 
out more). Paul hopes his students think the stuff he 
teaches is fun, too. 
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David Griffiths began programming at age 12, 
when he saw a documentary on the work of Seymour 
Papert. At age 15, he wrote an implementation of 
Papert’s computer language LOGO. After studying 
Pure Mathematics at University, he began writing code 
for computers and magazine articles for humans. He’s 
worked as an agile coach, a developer, and a garage 
attendant, but not in that order. He can write code in 
over 10 languages and prose in just one, and when not 
writing, coding, or coaching, he spends much of his 
spare time travelling with his lovely wife — and fellow 
Head First author — Dawn. 

Before writing Head First Programming, he wrote another 
book called Head First Rails, which is an excellent read 
and would make a thoughtful gift for any close friend or 
family member. 

You can follow him on Twitter at: 

http :// twitter.com/dgriffiths 
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starting t9 code 

Finding your way 

Writing programs gives you the power to control your PC. 

Almost everyone knows how to use a computer, but few people take the next step and 
learn how to control it. If you use other people’s software, you will always be limited by 
what other people think you want to do. Write your own programs and the only limit will 
be your own imagination. Programming will make you more creative, it will make you 
think more precisely, and it will teach you to analyze and solve problems logically. 
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textual data 

Every string has its place 

Imagine trying to communicate without words. 

All programs process data, and one of the most important types of data is text. In this 
chapter, you’ll work through the basics of textual data. You’ll automatically search 
text and get back exactly what you’re looking for. Along the way, you’ll pick up key 
programming concepts such as methods and how you can use them to bend your 
data to your will. And finally, you’ll instantly power up your programs with the help of 
library code. 
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et’s get organized 

s programs grow, the code often becomes more complex. 

nd complex code can be hard to read, and even harder to maintain. One way of 
managing this complexity is to create functions. Functions are snippets of code 
that you use as needed from within your program. They allow you to separate out 
common actions, and this means that they make your code easier to read and 
easier to maintain. In this chapter, you’ll discover how a little function knowledge 
can make your coding life a whole lot easier. 
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data ?!les and arrays 

Sort it out 

As your programs develop, so do your data handling needs. 

And when you have lots of data to work with, using an individual variable for each piece 
of data gets really old, really quickly. So programmers employ some rather awesome 
containers (known as data structures) to help them work with lots of data. More times 
than not, all that data comes from a file stored on a hard disk. So, how can you work 
with data in your files? Turns out it’s a breeze. 


Surf’s up in Godeville 

Find the highest score in the results file 

Iterate through the file with the open, for, close pattern 

The file contains more than numbers... 


Split each line as you read it 
The splitO method cuts the string 
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Hey, dude, ifs 
Chapter 4 … time 
for a break - lefs 
catch some waves. 
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Sorting is easier in memory 
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Putting data in its place 

Arrays aren’t the only show in town when it comes to data. 

Programming languages come with other data-arranging goodies too, and our 
chosen tool, Python, is no exception. In this chapter, you’ll associate values 
with names using a data structure commonly called the hash (better known as 
dictionary to Python-folk). And when it comes to working with stored data, you’ll 
read data from an external database system as well as from regular text-based 
files. All the world’s awash with data, so turn the page and start applying your ever- 
expanding programming skills to some cool data-processing tasks. 
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modular programming 

eeping things straight 

The code that you write will make its way into many programs. 

nd, although sharing is good, you need to be careful. One programmer might take 
your code and use it in an unexpected way, while another might change it without even 
letting you know. You might want to use one function in all your programs and, over 


time, that function’s code might change to suit your needs. Smart programmers take 
advantage of modular programming techniques to keep their workload manageable. 
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building a gtapliical user Interface 

Going all gooey 

Your coding skills are great and getting better all the time. 

It’s just a shame your programs are not that nice to look at. Displaying prompts 
and messages on a text-based console is all well and good, but it’s so 1970s, 
isn’t if? Add some green text on a black background and your retro look will be 
complete. There has to be a better way to communicate with your users than 
the console, and there is: using a graphical user interface or GUI (pronounced 
“gooey”). Sounds cool, but complex, and it can be. But, don’t fret; learning a trick or 
two will have your code all graphical in no time. Let’s get all gooey (sorry, GUI) in 
this chapter. 
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gms and dctta 

Data entry widgets 

GUIs don’t just process events. They also handle data. 

Almost all GUI applications need to read user data, and choosing the right widgets can 
change your interface from data entry hell to user heaven. Widgets can accept plain 
text, or just present a menu of options. There are lots of different widgets out there, 
which means there are lots of choices, too. And, of course, making the right choice can 
make all the difference. It’s time to take your GUI program to the next level. 


Head-Ex needs a new delivery system 
They’ve already designed the interface 
Read data from the GUI 

The Entry and Text widgets let you enter text data into your GUI 

Read and write data to text fields 

Large Text fields are harder to handle 
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There are too many depots on the GUI 
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excepti9ns and message boxes 

Get the message? 

Sometimes things just go wrong. You just need to handle it. 

There will always be things beyond your control. Networks will fail. Files will 
disappear. Smart coders learn how to deal with those kinds of errors and make 
their programs recover gracefully. The best software keeps the user informed 
about the bad things that happen and what should be done to recover. By learning 
how to use exceptions and message boxes, you can take your software to the 
next level of reliability and quality. 



What’s that smell? 294 

Someone changed the file permissions 295 

When it couldn’t write to the file, the program threw an exception 296 
Catch the exception 297 

Watch for exceptions with try/except 298 

There’s an issue with the exception handler 302 

A message box demands attention 303 

Creating message boxes in Python 304 

Your Programming Toolbox 311 


xviii 








table of contents 



gtapliical interface elements 

Selecting the right tool 

It’s easy to make your programs more effective for your users. 

And when it comes to GUI applications, there’s a world of difference between a working 
interface and one that’s both useful and effective. Selecting the right tool for the 
right job is a skill that comes with experience, and the best way to get that experience 
is to use the tools available to you. In this chapter, you’ll continue to expand your 
GUI application building skills. There’s a bunch of truly useful widgets waiting to be 
experienced. So, turn the page and let’s get going. 
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cust9tn Widgets and classes 

With an object in mind 

Requirements can be complex, but programs don’t have 
to be. 

By using object orientation, you can give your programs great power without 
writing lots of extra code. Keep reading, and you’ll create custom widgets that do 
exactly what you want and give you the power to take your programming skills 
to the next level. 
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The Top Ten Things (we didn’t cover) 

ou’ve come a long way. 

ut learning how to program is an activity that never stops. The more you code, the 
ore you’ll need to learn new ways to do certain things. You’ll need to master new 
tools and new techniques, too. There’s just not enough room in this book to show you 


everything you might possibly need to know. So, here’s our list of the top ten things we 
didn’t cover that you might want to learn more about next. 
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how to use this book 


Who is this book for? 

If you can answer “yes” to all of these: 


o 

O 

o 


Do you wish you had the know-how to control your 
computer and make it do new things? 


Do you want to learn how to program, so you can create 

the next big thing in software, make a small fortune, and ^ - 

retire to your own private island? 


0^, mayloc *bV^a-b orvcs a 

Bu-b, you ^otta 

s*t3v*b sowcv^cvc, v 吵七？ 


Do you prefer actually doing things and applying the stuff 
you learn over listening to someone in a lecture rattle on 
for hours on end? 


this book is for you. 


Who should probably back away from this book? 

If you can answer “yes” to any of these: 


o 

O 

o 


Are you a seasoned programmer? Do you already know 
how to program? 


Are you looking for a quick introduction or reference book 
to Python? 

Would you rather have your toenails pulled out by 15 
screaming monkeys than learn something new? Do you 
believe a programming book should cover everything and 
if it bores the reader to tears in the process then so much 
the better? 


this book is not for you. 


^ -this book 
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intro 


Wc know what youVe thinking 




u 


How can this be a serious Programming book?” 
What’s with all the graphics?” 

Gan I actually learn it this way?” 


Wc kwow what your brain is thinking 

Your brain craves novelty. It’s always searching, scanning, waiting for something 
unusual. It was built that way, and it helps you stay alive. 

So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with the 
brain’s real job — recording things that matter. It doesn’t bother saving the 
boring things; they never make it past the “this is obviously not important” 
filter. 

How does your brain know what’s important? Suppose you’re out for a day 
hike and a tiger jumps in front of you, what happens inside your head and 
body? 

Neurons fire. Emotions crank up. Chemicals surge. 

And that’s how your brain knows... 

This must be important! Don’t forget it! 

But imagine you’re at home, or in a library. It’s a safe, warm, tiger-free zone, n^ova^ 
You’re studying. Getting ready for an exam. Or trying to learn some tough 
technical topic your boss thinks will take a week, ten days at the most. 

Just one problem. Your brain’s trying to do you a big favor. It’s trying to 
make sure that this obviously non-important content doesn’t clutter up scarce 
resources. Resources that are better spent storing the really big things. 

Like tigers. Like the danger of fire. Like how you should never have 
posted those “party” photos on your Facebook page. And there’s no 
simple way to tell your brain, “Hey brain, thank you very much, but 
no matter how dull this book is, and how little I’m registering on the 
emotional Richter scale right now, I really do want you to keep this 
stuff around.” 
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Metacognition: thinking about thmking 

If you really want to learn, and you want to learn more quickly and more 
deeply, pay attention to how you pay attention. Think about how you think. 
Learn how you learn. 

Most of us did not take courses on metacognition or learning theory when we 
were growing up. We were expected to learn, but rarely taught to learn. 


I wonder how 
I can trick my brain 
into remembering 
this stuff... 



The trick is to get your brain to see the new material you’re learning as 
Really Important. Crucial to your well-being. As important as a tiger. 
Otherwise, you’re in for a constant battle, with your brain doing its best to 
keep the new content from sticking. 


But we assume that if you’re holding this book, you really want to learn how 
to program And you probably don’t want to spend a lot of time. If you want 
to use what you read in this book, you need to remember what you read. And 
for that, you’ve got to understand it. To get the most from this book, or any book 
or learning experience, take responsibility for your brain. Your brain on this 
content. 


So just how DO you get your brain to treat 
programming like it was a hungry tiger? 


There’s the slow, tedious way, or the faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are able to learn 
and remember even the dullest of topics if you keep pounding the same thing into your 
brain. With enough repetition, your brain says, “This doesn’t feel important to him, but he 
keeps looking at the same thing over and over and over, so I suppose it must be.” 


The faster way is to do anything that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 


A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing is, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 


But pictures and conversational style are just the beginning … 
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Here's what WE did: 

We used pictures, because your brain is tuned for visuals, not text. As far as your brain’s 
concerned, a picture really is worth a thousand words. And when text and pictures work 
together, we embedded the text in the pictures because your brain works more effectively 
when the text is within the thing the text refers to, as opposed to in a caption or buried in the 
text somewhere. 

We used redundancy : saying the same thing in different ways and with different media types, 
and multiple senses, to increase the chance that the content gets coded into more than one area 
of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for novelty, 
and we used pictures and ideas with at least some emotional content, because your brain 
is tuned to pay attention to the biochemistry of emotions. That which causes you to feel 
something is more likely to be remembered, even if that feeling is nothing more than a little 

humor, surprise, or interest. 


We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you’re reading. 


We included more than 80 activities ， because your brain is tuned to learn and remember 
more when you do things than when you read about things. And we made the exercises 
challenging-yet-do-able, because that’s what most people prefer. 

We used multiple learning styles, because joz/ might prefer step-by-step procedures, while 
someone else wants to understand the big picture first, and someone else just wants to see 
an example. But regardless of your own learning preference, everyone benefits from seeing the 
same content represented in multiple ways. 

We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can stay focused. 
Since working one side of the brain often means giving the other side a chance to rest, you 
can be more productive at learning for a longer period of time. 

And we included stories and exercises that present more than one point of view ， 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 

We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work at 
something. Think about it — you can’t get your body in shape just by watching people at the 
gym. But we did our best to make sure that when you’re working hard, it’s on the right things. 
Thatj^oiiV^ not spending one extra dendrite processing a hard-to-understand example, 
or parsing difficult, jargon-laden, or overly terse text. 

We used people. In stories, examples, pictures, etc., because, well, because a person. 
And your brain pays more attention to people than it does to things. 
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Here's what YOU caw do to bend 
your brain into submission 

So, we did our part. The rest is up to you. These tips are a 
starting point; listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 

Cu*t -this ou-fc 3hd 乙 k |七 

° h y ° 你 


o Slow down. The more you understand, the 
less you have to memorize. 

Don’t just read. Stop and think. When the book asks 
you a question, don’t just skip to the answer. Imagine 
that someone really is asking the question. The 
more deeply you force your brain to think, the better 
chance you have of learning and remembering. 

o Do the exercises. Write your own notes. 

We put them in, but if we did them for you, that 
would be like having someone else do your workouts 
for you. And don’t just look at the exercises. Use a 
pencil. There’s plenty of evidence that physical 
activity while learning can increase the learning. 

❺ Read the “There are No Dumb Questions” 

That means all of them. They’re not optional 
sidebars, they ’re part of the core content! 

Don’t skip them. 


o Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 

o Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s time 
for a break. Once you go past a certain point, you 
won’t learn faster by trying to shove more in, and 
you might even hurt the process. 

o Feel something. 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke 
is still better than feeling nothing at all. 


Make this the last thing you read before bed. 
Or at least the last challenging thing. 


Part of the learning (especially the transfer to 
long-term memory) happens afteryow put the book 
down. Your brain needs time on its own, to do more 
processing. If you put in something new during that 
processing time, some of what you just learned will 
be lost. 


(@) Talk about it. Out loud. 

Speaking activates a different part of the brain. If 
you’re trying to understand something, or increase 
your chance of remembering it later, say it out loud. 
Better still, try to explain it out loud to someone else. 
You’ll learn more quickly, and you might uncover 
ideas you hadn’t known were there when you were 
reading about it. 


Write a lot of code! 

There’s only one way to learn to program: writing 
a lot of code. And that’s what you’re going to 
do throughout this book. Coding is a skill, and the 
only way to get good at it is to practice. We’re going 
to give you a lot of practice: every chapter has 
exercises that pose a problem for you to solve. Don’t 
just skip over them — a lot of the learning happens 
when you solve the exercises. We included a solution 
to each exercise — don’t be afraid to peek at the 
solution if you get stuck! (It’s easy to get snagged 
on something small.) But try to solve the problem 
before you look at the solution. And definitely get it 
working before you move on to the next part of the 
book. 
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Read Me 

This is a learning experience, not a reference book. We deliberately stripped out everything 
that might get in the way of learning whatever it is we’re working on at that point in the 
book. And the first time through, you need to begin at the beginning, because the book 
makes assumptions about what you’ve already seen and learned. 


This is not Head First Python. 

We use release 3 of the Python programming language throughout this book, but this 
fact alone does not make this book Head First Python. We chose Python because it’s a great 
programming language to start with and it’s also a great programming language to grow 
with. In fact, Python might be the only programming language you’ll ever need to learn 
and use (although your employer might think otherwise). Of course, you have to start with 
something, and we can think of no better programming language to use than Python when 
first learning how to program. That said, this book isn’t designed to teach you Python; 
it’s designed to teach you programming, so most of the things we show you are designed to 
hightlight the programming concept, not the Python feature. 


You need to install Python 3 on your computer. 

To run the programs in this book, you need to download and install Python 3 on your 
computer. This isn’t as hard as it sounds. Pop on over to the Python download site and 
select the option that fits best with the computer you are using. Just be sure to select release 
3 of Python, not release 2: http: / / zvzvzv.python. org/download. 

We begin by teaching some basic programming concepts, then we 
start putting programming to work for you right away. 

We cover the fundamentals of programming in Chapter 1. That way, by the time you 
make it all the way to Chapter 2, you are creating programs that actually do something 
real, useful, and — gulp! — fun. We are guessing you’ll be amazed by how much you can do 
with less than a dozen lines of code in Chapter 2. The rest of the book then builds on your 
programming skills turning you from programming newbie to coding ninja master in no time. 
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The activities are NOT optional. 


The exercises and activities are not add-ons; they’re part of the core content of the book. 
Some of them are to help with memory, some are for understanding, and some will help 
you apply what you’ve learned. Don } t skip the exercises. 

The redundancy is intentional and important. 

One distinct difference in a Head First book is that we want you to really get it. And we 
want you to finish the book remembering what you’ve learned. Most reference books 
don’t have retention and recall as a goal, but this book is about learning, so you’ll see some 
of the same concepts come up more than once. 

The examples are as lean as possible. 

Our readers tell us that it’s frustrating to wade through 200 lines of an example looking 
for the two lines they need to understand. Most examples in this book are shown within 
the smallest possible context, so that the part you’re trying to learn is clear and simple. 
Don’t expect all of the examples to be robust, or even complete — they are written 
specifically for learning, and aren’t always fully-functional. 

We’ve placed a lot of the code examples on the Web so you can copy and paste them as 
needed. You’ll find them at two locations: 


http:/7www.headfirstlabs.com/books/hfprog/ and 


http:/ / programming.itcarlow.ie 

The Brain Power exercises don’t have answers. 


For some of them, there is no right answer, and for others, part of the learning 
experience of the Brain Power activities is for you to decide if and when your answers 
are right. In some of the Brain Power exercises, you will find hints to point you in the 
right direction. 
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Technical Reviewers: 


Doug Hellmann is a Senior Software Engineer 
at Racemi and former Editor in Chief for Python 
Magazine. He has been programming in Python since 
version 1.4 and prior to Python worked mostly with G 
on a variety of Unix and non-Unix platforms. He has 
worked on projects ranging from mapping to medical 
news publishing, with a little banking thrown in for 
good measure. Doug spends his spare time working on 
several open source projects; reading science fiction, 
history, and biographies; and writing the Python Module 
of the Week blog series. 

Jeremy Jones is the coauthor of Python for Unix and 
Linux System Administration and has been actively using 
Python since 2001. He has been a developer, system 
administrator, quality assurance engineer, and tech 
support analyst. They all have their rewards and 
challenges, but his most challenging and rewarding job 
has been husband and father. 


Ted Leung has been programming in Python since 
2002 and is currently a Principal Software Engineer 
at Sun Microsystems. He has a Bachelor of Science 
degree in Mathematics from the Massachusetts Institute 
of Technology and a Master’s of Science degree in 
computer science from Brown University. Ted’s weblog 
is available at http://www.sauria.com/blog 

Bill Mietelski has been an Information Technology 
geek for over 20 years. He’s currently a Software 
Engineer at a leading national academic medical center 
in the Ghicagoland area, working on statistical research 
studies. When he’s not at the office or tied to a computer, 
you’ll find him at a golf course chasing a little white ball. 
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safari books online 


Safari® Pooks Online 


Safari^ 

Books Online 


When you see a Safari® icon on the cover of your favorite 
technology book that means the book is available online 
through the O’Reilly Network Safari Bookshelf. 


Safari offers a solution that’s better than e-books. It’s a virtual library that lets you 
easily search thousands of top tech books, cut and paste code samples, download 
chapters, and find quick answers when you need the most accurate, current 
information. Try it for free at http : // safari . oreilly. com. 
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1 starting to code 




f Finding your way 



I wish ''sweet cheeks" here 
would finish with the polishing 
Ive got to re-bore the cam 
shaft and reprogram the EMS 
for Saturdays drift race. 


Writing programs gives you the power to control your PC. 

Almost everyone knows how to use a computer, but few people take the next step and 
learn how to control it. If you use other people’s software, you will always be limited by 
what other people think you want to do. Write your own programs and the only limit will be 
your own imagination. Programming will make you more creative, it will make you think 
more precisely, and it will teach you to analyze and solve problems logically. 

Do you want to be programmed or be the programmer? 


this is a new chapter 




take control of your computer 


Programming lets you do more 


You’ve got problems to solve and work to do, but your existing software 
doesn’t quite cut it. Even with all those programs on your computer, 
you still need to do something different, something specific to you. 


How do I get 
my website to do 
what I want? 


O 


0 



You want to do more with your computer. You want to take control 

Learning to program gives you the power to create and solve. 
Learning to program puts you in charge. 

But, how does programming work? 

Let’s look at a simple game written in Python. 
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arpen your pencil_ 

\ This code is a guessing-game program. Study it carefully, and 

opposite each line of code in the program, write down what you 
think the code does. If you’re not sure what a particular line of 
code does, don’t worry, but try to guess anyway. One line has 
already been entered to get you started: 

print("Welcome!") 
g = input("Guess the number : ") 

guess = int (g) Cohyc\r*t -the mfut to a number. 

if guess == 5 : 

print("You win!") 
else : 

print("You lose!") 
print ("Game over !’，） 


This toAt is i h 

如 se W ^ PyiL 

l^9ua 9 c, whi^h 

_ s UScd ^^ou 9 hou-t iWis book. 
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guessmg games 


«^Sbarp your pencil 

Solution 


print("Welcome! 


g = input ( "Guess the number : ’， ） 


guess = int(g) 


This code is a guessing-game program. You were to write down 
what you think the code does. 

y 败釙她把 

d 勹⑽七佯咖 0 的 . $ 诎 

similair, thch cvcvy-thihft is 0^. r ,., , 

.display a. y/cldp^c message ； . 


if guess 


5 : 


print("You win!") 


else : 


print ("You lose !，'） 


print ("Game over !’，） 


jf\sk -the user ip a ^ucss. 
Cohyc\r*t *thc rnfut joo a humbc\r ; 
l/Vas -the guessed number c^ual -to 5? 

Tell *thc user u you v/.m!” 

Othcrvyisc... 

: the usevr W you J. 网 !，: . 

Ehd -the pyogy-aw). . 


Put what are 2 and guess? 

You might be wondering what g and guess are in the code. They are 
called variables and they’re used to keep track of data in the computer’s 
memory. 



rT^. vsluc ^i^ed Will 

I be khowh as u g w 
=input("Guess the 


number : 


A 


v ^bl c 


guess = int(g) 


\ 


TWis a 

一 。 J a,d 

talU vt V ss . 



A variable is really just a label for data. So if the user inputs “3” at the 
keyboard, then guess will be set to the number 3, and whenever the 
computer reads guess, it will read it as the value 3. 



Be careful with 
=signs in code. 

Programming 
languages use = 
signs for different 


purposes. In most languages 
(including Python), a double 
equals (==) is a test for equality. 
It means, “are these two things 
equal?” In contrast, a single 
equal (=) is an instruction 
(known as assignment) that 


means “set the value to. 
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starting to code 


So how do you ruw your code? 

There are two things that you will need to run the guessing-game 
program: an editor and an interpreter. 

The editor saves the code you write into a file on your hard disk. The 
code (sometimes called the source code) is just text, and it can be 
written and read by humans. 


The 





c d'tio\r y/ill 


ihe 





But computers can’t process text meant for humans’ at least not very well. 
That’s why we need a tool to translate the human-friendly source code 
into the binary Is and Os that computers do understand. That’s what an 
interpreter does. In this book, an interpreter called Python is used. 



O 



Thc Pyihoh 


todt la 明 e 


6ow\ 




So we need an editor and a Python interpreter. Fortunately, Python 3 
comes with a built-in application called IDLE, which does both jobs and 
more. IDLE enables you to write and edit Python code, it translates this 
code into binary form, and finally, it runs the Python 3 program. Because 
of this, IDLE is known as an Integrated Development Environment. 


Let’s see these steps in action. 
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open the shell 


Create a new program file 

When you first start IDLE, it displays a window called the Python Shell. 
Select the New Window option from the Python Shell File menu, 
which creates a new edit window for you. Input your program code as text 
into this edit window and you’ll be on your way. 


TW»s \s 





Pyt h □ n Shfiill 


pile tdit Shel l^iebug Uptions Windaws 

,Ftb IT 2^0#. 133 15 ： 51 li 


Wwdpw 

QpL'fl... 

R| lilt FeI<». 


CUI-N 

Ctfi+S 


渉 kIliIhv g 

A\l+M 

dn graw^r 

Alr+C 

ElrflWipr 



a!i.s| 

KilVI 1 


£! 口 n A u . 

AJt+Sh 

Prml Window 

Ctxl+P 

tlas€ 

AJLU4 

fexrt 

(arl-y 






lor more LnlormBt >.on ^ 


o —。 灼 


TV,c Ncvi ^ 



This is ah IDLB 

edit wihdow. 



Untitled* 


£«|p [flit Fnrmflt Run OphionR, Winfffvw's 


print E n Wc _co[T,cJ n ) 

cj *s i ； riptaL. ( ' 'ji - 1 rLLEr'l.-r! 

guesa — int^g) 

I == *5 1 

print ( " ^ern .win I" 

' ir- z 

print 「 5 fo.ii Id b 8 L 

p-r l nt ( H fin—r ii-vrT !! M ) 


了 Py-thoh pvogiram is 乙 olov — 
hded withih IDLB's edit 
wihdow. This Colov-todiha 
is -to as M sy h ia 

Be su^c io 

the 仏 dc m EXACTL/ ^ it 


this! 





5ppC3\rs hcirc. Poh ； *t -Povact 

li «w , . j'* u 

those : ^hava^-tev* 



Go ahead and open a new IDLE edit 
window and type in the code from page 


丁 Wis is how IVLS looks cm chav TWy 

look a little a»^W^ or. yours. Por. i 
y/o^rvv ： tVic IPLE m ⑽ system a^d IPLts 
b^avior should be same, r^ardlcss <A 
ofcv"3t>y\^ system youV"C 
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Prepare and ruw your code 


The next step is to prepare your program code for execution. To do this, 
select File —> Save from the menu to save your program code to a file. 
Choose an appropriate name for your program. 


you choose File S avc 

W you s 3 vc 

yo^r toAt ih a -file. 



It doesn’t really matter to IDLE which directory you save the file in. Some 
coders like to create special directories for each new programming project. 
But for now, just save the code in some directory that’s easy to remember. 


Now, let’s see what happens when we run the program. 



gamfl>；py - 


Hip [nk.t fnrmRt Rim Ojitirun^ Windows 


print ( '' Wc 1 coisc J 
y e _l_rLptiL( " Guta F^thCMl Shell 

guG3a 圓 intjg) - 

■ yutsa == 5 2 Ch<ELk Module Alt 十 X 
print 厂 You 


Djrmt [ " 5fou load 
pi • 丄 a]L ( u-v tfL l " J 
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test drive 




Tesr DriVq 


To run the program, you need to make sure that the edit window for 
the game . py program code is selected. Each time you run (or rerun) 
the program, you need to click on the IDLE edit window and choose 
the Run Module option from the Run menu. The word module is 
a name that IDLE uses to refer to your program code. 

Here’s what happens when you run the code: 


you vuh youir todt withih IDLB, 
jy ^ssa 9 « withm the Pytho, 

h 。十 the edit window 7 

[ PLb ih c shell the 

dmil Y 韻 d window -the 
yowr pirogiram vuhs. 





Congratulations! The program works. 

Each time you run the code, it displays a “Welcome!” message, 
accepts input from the keyboard, and then tells us whether or not 
we guessed the right answer. That means the program is accepting 
input, it’s processing the data, and then it generates output. 
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I’ve never heard of Python. Is it 
popular? 

Python is used in lots of cool places. 
Google, Industrial Light & Magic, YouTube, 
and NASA (to name a few) all use Python. 
We think they know what they’re doing. 

So, when I’m done with this 
book I’ll throw Python away and use 
something else, like C# or Java? 

Only if you want to. Python might be 
the only programming language you’ll ever 
need. But, yes, if you want to learn another 
programming language, you can take 
everything you learn about programming in 
this book and apply it to any other language 
with the minimum of effort. 

But a buddy of mine told me I 
should learn Java or C#. Why are you 
not using either of these programming 
languages in this book? 

Both Java and C# are great 
programming technologies, but they can be 
difficult to learn, especially when you are 
just starting out. This is not the case with 
Python. And, anyway, this is a book that’s 
designed to teach you how to program, and 
using Python as your first programming 
language will help us to do just that. 

There seems to be many different 
versions of Python. Which should I use? 

There are two main releases of 
Python: 2 and 3. This book is based on 
release 3 of the language. Python 3 is the 
future of the language; any new features 
are guaranteed to be added to release 3 
of the language, not release 2. Of course, 
like all releases, Python 3 remains a free 
download, which makes it a no-brainer 
when decidiing if you can afford to use it. 



e nQ 

Questi9ns 


Will Python run on my phone, just 
like Java? 

That really depends on your phone. 
Python is designed to run on lots of 
different technologies and operating 
systems. Running your own code on your 
own phone is a very specific requirement, 
and Java has that pretty well covered at 
the moment. As a programming technology, 
Java was initially designed to run on very 
small devices, so it is no big surprise that 
it is a strong and popular choice when it 
comes to telephony. 

Why is the Python IDE called 

IDLE? 

It’s partly because it sounds like IDE, 
but we suspect that it has more to do with 
Eric Idle, one of the founding members of 
the Monty Python’s Flying Circus comedy 
group. 

w. Come again?!? Monty Python’s 
Flymg what? 

Circus. Yes, we know: sounds silly, 
doesn’t it? And, believe us, it is. It's funny, 
too. The creator of Python, Guido van 
Rossum, is a big Monthy Python fan and 
reportedly watched the show’s reruns 
while he designed Python. You’ll find lots 
of references to Monty Python folklore in 
the Python community. Dead parrots are a 
particular favorite. 

What does int(g) mean? 

It tells Python to interpret the user’s 
input as a number rather than a letter. 

Within programming languages, the number 
5 is different than the letter ‘5’. 


So what if we’d left it out? 

The computer would have treated the 
input entered by the user of the program as 
a letter. If you ask the computer if a letter 
is equal to a number, it gets confused and 
tells you it isn’t. 

Why’s that? 

Because if the computer thinks that 
two pieces of information are of different 
“types,” it assumes that there’s no way they 
can be equal. 

So what if I had not typed a 
number when I was asked for a guess? 
What if I’d just entered my name or 
something? 

The code would have crashed with an 
error. In fact, Python will complain that the 
program crashed with a “ValueError” (more 
on these error messages later in the book). 
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give a hint 


Ov\t 70UV USCVS 



I don’t get it. How am I 
supposed to guess the winning 
number? All the program tells 
me is that my guess is right or 
wrong. Come on y give me some 
help here! 


The program needs to do more. 

At the moment, the guessing game tells the user whether his 
guess is right or wrong, but nothing more than that. It might 
be more helpful if the program displayed more informative 
messages, such as whether the guess is higher or lower than 
the correct answer. That would help the user to hone in on the 
right answer the next time the program is run. 

We can do this by changing the code. But in what way? 


*tWis 

-to d»sflaY 你 essays 七 ha 七 
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starting to code 


r "^l? ar p en y our P en ⑸ _ 

^ ‘ You need to decide what messages should be displayed to the 

user. Below is a table showing some typical values the user might 
enter. What do you think the message should say? 






Think about the original code. You will need to use 
more than just print () commands to provide 
more informative feedback. What else will you 
need? 
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code is a highway 



encil 


「pen your penci 
V Solution 


You needed to decide what messages should be displayed to the 
user. Below is a table showing some typical values the user might 
enter. What did you think the message should say? 



A program is more thaw a list of commands 


You could create a program that was simply a list of commands. But you 



almost never will. This is because a simple list of commands can only be 
run in one direction. It’s just like driving down a straight piece of road: 
there’s really only one way of doing it. 




print 
("Come 
again!") 


print 
("Howdy!") 


But programs need to be much smarter than that. 
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starting to code 


Codeville: Your program is like a network 
of roads 

Programs need to do different things under different circumstances. In 
the game, the code displays “You win!” if the user guesses the number 
correctly, and “You lose!” if not. This means that all programs, even really 
simple programs, typically have multiple paths through them. 



A path refers to the set of instructions that the computer will actually 
follow (or execute). Your code is like a street network, with lots of sections 


d\rc 


cvcv-y pv-ojv-am -that a\rc like 
vodd *m*tcv-scdtioir\s. 


The 匕 ompu*t 饮 


-the 、，丄 l" 


ihirough U 


or 


av-c mahy v-oads C. 

paths) -through -the 匕 ode. 


of code connected together just like the streets in a city. When you drive 
through a city, you make decisions as to which streets you drive down by 
turning left or right at different intersections. It’s the same for a program. 
It also needs to make decisions from time to time as to which path to take, 
but for your code, it is not like driving along a road, it’s executing a particular 
path. 


Let’s look in more detail at how a program decides 
which path to take. 
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fork in the road 


Pranches arc code mtcrscctiows 


Driving down a street is easy. You need to make a decision only when 
you get to an intersection. It’s the same for your program. When a 
program has a list of commands, it can blindly execute them one after 
another. But sometimes, your program needs to make a decision. Does 
it run this piece of code or that piece of code? 



These decision points are called branches, and they are the road 
intersections in your code. 


av-c 


like \road 


Your program makes a decision using a branch condition. A branch 
condition has the value true or false. If the branch condition is true, it 
runs the code on the true branch. And if the branch condition is false, it 
runs the code on the false branch. 


tomfu-tcv- y/*ill -take -bii'is 

丁 V)V3^ tcmdvticw *brue 一仏 a 七 is, yss 





wiii is kc iWls , 

is, 



The ^alsc 
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starting to code 


if/dse branches 

We’ve already seen a branch in the Python game program: 


if guess == 5 : 




print ( n You win! n )| 
else : 

print ( n You lose! n ) 
print( n Game over! n ) 


Python, like many languages, has if/ else branches. In our example, 
the branch condition is the if guess == 5 piece of code. This is a 
test for equality and it will result in the value true or false. 

The code on the true path is indented, and given after the if line. The 
code on the false path is indented, and given after the else line: 


TV^CSC 

avc 


guess==5? 


print 

("Game over! M ) 


print 

("You win! M ) 


You need to amend the game program to give more informative messages 
to the user. 


But what will the paths in the program look like? 
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start your engines 




The v-adc 
stav-t lihC is 
-fixed hcv-c. 


Race Track 
Construction Kit 


►»»»»»»»»»>5 


The countdown’s started on the Codeville Grand Prix. The 
cars have arrived, they’re warming their tires on the grid, 
and the race is about to start. Can you assemble the track 
so that it displays the right feedback message? Note that 
you might not need all the pieces of track. 


Number entered 

Feedback message 

3 

Too low 

5 

You win! 

7 

Too high 

8 

Too high 


guess 



►>»»»»»»»»»>»»»»» 
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»»»»»»»»»»»»»»»] 




TV^c vatc 
Jf Ws “〆 、 s 





»»»>>»»»»»»»»»»»1 



FINISH 
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finish line 


t* 


各 Race Ttack 

Construction Kit Solution 






The countdown’s started on the Codeville Grand Prix. The 
cars have arrived, they’re warming their tires on the grid, 
and the race is about to start. Were you able to assemble 
the track so that it displays the right feedback message? 




Number entered 

Feedback message 

3 

Too low 

5 

You win! 

7 

Too high 

8 

Too high 


print 


("You win! n ) 


quess==5? 


guess 


>y>yyyyyyyy>yyyyyyy>yyy»yyy>yy 
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starting to code 


)»»»»»»»>»»»»»»»】 





print 

("Too high") 





print 

("Game over!’'） 



»»»»»»»»»»»»»»»1 


■ 


FI 
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connect branches 


The Pythow code needs 
mtcrcowwcctiwg paths 

The solution’s mapped out, and now we know that the program code will 
need to have paths that match this: 


㈣ 一 t 

V guess 二 ! 





But isn’t there a problem here? In the design there are many interconnecting 
paths, but so far, we have only written code that contains just one branch: 


if guess == 5 : 

print("You win!") 
else : 

print ("You lose !’'） 


In the new code, we will need to connect two branches together. We need the 
second branch to appear on the false path of the first. 



iVc y\ttd *to 

^-these *tv/o paths ~^ 

•bojrthcv- 



So how do you connect branches together in Python? 
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starting to code 


Pythow uses indents to connect paths 

The code inside the if and else statements is indented. This isn’t just 
to make the code pretty. In Python, indents matter. Let’s consider a 
different piece of example code: something that will decide if you can 
drive downtown. Python uses indents to connect a sequence of commands 
together to form paths. 


TWis \s 

TRUE 


This is 七 he 

FALSE paih. 




if 

if fuel > 3 : 


如 … the sar>»e path 




print (’’It’s 0K M ) 

print ("You can drive downtown .’，） 
else;: 

print("Sorry") 

print("You don't have enough fuel") 
print("What's next?") 

TV^'is Command is Ysoi -tV>c 
FALSE ㈣ because •丨七 mo 七 
\^dtM So -.1 V,ll 3 1 哪⑽ 


So how do you connect branches together? You simply indent the 
second branch in by one more level. 




U，s sc ^d 

ur f°T c6icd io ih c 

士丨 4 4 bm 釙匕 h . 


if fuel ：> 3 : 

Iprint ("It's OK") 

print ("You can drive downtown .，'） 
else : 

if rnoney > 10: 

print("You should buy some gas. 
else : 

rint("You better stay at home. 
s next?") 


Iprin 
ti\ "What' 

L: ^. /ii 


prirr 

Noii 匕 c ihe cx-tv-a 

•^dctrtd-tioh. 



Indents matter 
in Python. 


\ir^ n t uf Be careful how 

1L. y 0U indent code in 
Python; if you don’t 
indent your code correctly, your 
code might do something wildly 
different from what you expect 


You should now have enough information to go fix the code, but 
before we do that, let’s take a look at how IDLE helps you indent 
code. 
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idle time 


IDLE ...ata glance 


You’ll be using IDLE to enter all of the Python code in this book, so it’s 
worth taking a little time to familiarize yourself with a few of its features. 

Even though IDLE looks like a simple editor, it’s actually packed full 
of smarts that will make Python programming much easier and faster 
for you. It’s worth spending some time exploring IDLE’s menus and help 
system, but for now here’s a few handy hints to help you feel at home. 


.11 


tKTtR, ^ 

auWat^allv 

•，於如七如 W W 7 ⑽ • 



丫 = 如 ihc way 

lPup. uses £.olo\rs 

^ 以叫 by di^ d 0h ihc 

ptiOhs r^Chu (or) ih c ^ 

丨七 galled P^rcfc\rc^cs). 


TV^ ttcl? wCvma i\oi oA^ 
awes VOU \\t\^ atou-t 
IPUt, but also lets 70U 
代 ad 如 Wlm P#w 
(jioduw'CV'*t3"t ,oy '* 


EiEe Edit Format Jlun Options Windows 


fuel > 3: 
print(’I 
print 


a UVTl J 

.can drive dowritown. ^ 



mnn^y > If): 

print { 10 You should buy 

€■ l 

piir,t { 11 You better sta 
■nt t ’|W:' • 二 - 1 □ nCKt ? m )[ 


Bc-Po\rc you type ih u clsc： w , make 
su 代 you hit KAC*SPACE -to 
^ovc the i^dcht badk ohe level. 
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starting to code 


Paa] Plizzjc 

Your task is to take the Python code 
fragments from the pool and place 
them into the blank lines in the 
game. You may not use the same 
code fragment more than once, and 
you won’t need to use all the code 
fragments. Your goal is to complete 
the guessing game program. 

Hint: Don’t forget to indent. 

print("Welcome! M ) 
g = input("Guess the number : ") 
guess = int(g) 



Note: each code 



fragment from the 
pool can be used only 
once! 


lose 


ame 


you 


over 


rint ( 


yuess 


else 


guess 


if 


win ”） 


You 


rint( 




else 


low 


Too 


print( 


< 


guess 


if 
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indent or else 


Paa] puzzjc 

Your task was to take the Python code 
fragments from the pool and place 
them into the blank lines in the 
game. You could not use the same 
code fragment more than once, 
and you didn’t need to use all 
the code fragments. Your goal 
was to complete the guessing game 
program. 

Hint: Don’t forget to indent. 



print("Welcome!") 



jVis Codt 

-the -fiirst vc^sioh 
o\ iWis 
lohjCV 
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Tost DriVq 


So, what happens if you run the new version of the program? 

Let’s try a few tests. Remember, you will need to switch back to the 
program window for each run and choose Run module from the menu. 


Python Shell 


hiSe bdit bhell uebug! uptions windows 

Python 3.0.1 (rJOIs€95&6 J Fab 17 2Q09, 15:15:57) 

|GCC 4,3 _ 2 I on linux2 

Type " copyright 11 x " er edit a n or "license { ) " for more i. n format ion 
»> ================================ UFISTIRT ================== 

>>> 

WrI c?nmp! 

Gueas the number: 3 ^ 〆 Looks like 七 he *f’iv*s 七 Jucss v/as ioo 

To ° low low, so Y/C t\tt& *bo *tvy a^am- 

Game over E 

================================ RESTART ================== 

»> 

Welcome! y Wow the guess is ioo high. 

Guess the number: 7 / Lei's have a^oihe^r a Q) ahd." 

Too high 
Game over! 

>» ================================ RESTART ================ = 

>» 

You win! toYYttt a^swc\r. 

Game over S 

»> I 


He^p 


— 


Ln ： 12 col: 4 


The program works! But，are the users any happier? 
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another guess 




The users still don’t like it. 

The program works, and now generates extra feedback, but 
there’s a problem. If the users want to have another guess, they 
have to run the program again. They really want the program 
to keep asking them for another guess until they finally get the 
correct answer. 

Can you see what the problem is? 

How do we get the computer to do something repeatedly? Should 
we just make a copy of the code and paste it at the end of the file? 
That would make sure the user is asked twice. But what if they 
need to make 3 guesses? Or 4 guesses? Or 10,000 guesses? 
What about the case where the guess is correct? 

The guessing game program needs to be able to 
run some code repeatedly. 
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starting to code 



Wouldnt it be dreamy if 
there were a way to get a piece 
of code to run several times? 
But I guess \Ys just a fantasy... 
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loop around 


Loops let you ruw the same piece 
of code over and over again 

Programs often need to keep running the same piece of code 
many times. In addition to branches, programming languages also 
provide loops. 


Loops are a little like branches. Just like branches, loops have a 
condition (the loop condition) that is either true or false. Also, 
like the if part of branches, if the loop condition is true, then 
a loop will run a given piece of code. For a branch, this code is 
called the body. For a loop, it’s called the loop body. 



answer = 
input("Are 
we there?") 


print 

("We r re 
there!") 




FAL^B 




answer= M no 




thc lo °? ^Ohdiiioh bc4v 


dc ^ idih 9 -to do hexi 


The big difference between a loop and a branch is how many 
times it runs the code associated with it. A branch will run its code 
only once. But a loop will run the loop body, then check the loop 
condition again and, if it’s still true, it will run the loop body again. 
And again. And again. In fact, it will keep running the loop body 
until the loop condition becomes false. 
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starting to code 


Python's while loop 


Programming languages have lots of different ways of creating loops, 
but one of the simplest ways in Python is to use a while loop. Here’s 
an example: 


: t 


^ W — S 

Jf Vrst 七一 • 

answer 
while answer 


The 

/ 


"no" 


If 


°°P ^Ohdiiio, 


no 


If 



n f l y ^ody is -the 

㈣ t 4 — 


answer 


=input("Are we there? 
print ( n We T re there ! TT ) 


This is what the loop looks like when you write it as a Python while loop. 
The code keeps asking the question “Are we there?” until the user types 
something other than no. This is what it looks like when it runs: 


TV 


Uc loop body \s just Imc ^ d 

of todc. \i 州吵七⑽ 
a”d o 七 loops. 


be Ucs 4 
m^lude Way\^cs 



Did you notice that you had to set the value of the answer variable to 
something sensible before you started the loop? This is important, because 
if the answer variable doesn’t already have the value no, the loop 
condition would have been false and the code in the loop body would 
never have run at all. 


Bear that in mind. It might be useful in this next exercise 
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change the game 



Now ， it’s time to apply your programming mojo. Be warned: this exercise is kind of tricky. 
You need to rewrite your game program so it keeps running until the user guesses the 
correct answer. You will need to use all of the things you've learned in this chapter. You will 
need to work out the conditions for each of the branches and loops that are required. 

Remember: the program needs to keep asking the user for an answer while the current 
guess is wrong. 


Hint: If you need to test that two things have different values, use the != operator. 



This is the U hot 
c«\ual -to w opeva-tov-. 


todc 
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starting to code 



If you add these two lines of code to the top of your program: 


from random import randint 
secret = randint(1, 10) 


The secret variable will be set to a random number between 1 and 10. Modify your 
program from the facing page so that instead of the answer always being 5, it will 
instead use a random number from 1 to 10 as the answer. 


\AM 七 c 如心七 代 — d 7 <> 广 

\ W TW»s 7ouv 

"一 v 丄 e 0 n^ 

v>vo<\vaw uses tnc 

； a,iaWe as *tV,e 
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new game 

ExeRdSe - 

fl^^goLutlOH 

You needed to rewrite your game program so it keeps running until the user guesses the 
correct answer. You needed to use all of the things you’ve learned in this chapter. You 
needed to work out the conditions for each of the branches and loops that are required. 

Hint: If you need to test that two things have different values, use the != operator. 
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starting to code 



keapy Baw 

■V 

0 >pe 

If you add these two lines of code to the top of your program: 


from random import randint 
secret = randint(1 , 10) 

The secret variable will be set to a random number between 1 and 10. You were to 
modify your program from the facing page so that instead of the answer always being 
5, it will instead use a random number from 1 to 10 as the answer. 


Heve av-c 

V mC s 10 ) 

rBv\dov^ vwawoCV- 


产 


七 ('Weldome") 

^ucss =■ 0 

while guess 1==^ secrej：'- 



else ： 

p\rm*t^ U "foo low") 
ovc\r| W ) 
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test drive 




Tesr DriVq 


So, what happens when you run the new version of your program? 



This games pretty cool. 

No matter how many 
times I play it, I still have 
to think to get the right 
answer! 


Your users love the program. 

And you created it all yourself. By carefully analyzing the problem, 
deciding what the feedback needed to be, and working out the intricate 
looping and branching logic, you’ve created something that really rocks. 

Well done. You’re on your way to becoming a real code 
jockey. 


O 


o 
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starting to code 



Your Programming Toolbox 

You’ve got Chapter 1 under your 
belt. Let’s look back at what 
you’ve learned so far. 


氺 pvo^a^s avc ^ 

do 脚 . 

\oo ? s — 脚 . 

冰 蠄 r ^ d ；； 

—A〆 咖 _ 

* st 二 

* A 一 ― Wc 、 s 如 


Py 七 hoh 7ools 




•-P/clsc b 





^ while loops 
蛱 — assig hmeh ^. 

♦ 二二 opc^W 

* ! 二 丨， 汕士 y op^U 

3 ⑹ WU op^U 

:喊 di 卿〜， 

d 4 一 -㈣ 

心 一 is 士 hu ^ m 

二 ^ o PK 叫 “ 
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2 t&Stusd dcttct 


Every string • 

參 has its place 



Imagine trying to communicate without words. 

All programs process data, and one of the most important types of data is text. In this 
chapter, you’ll work through the basics of textual data. You’ll automatically search 
text and get back exactly what you’re looking for. Along the way, you’ll pick up key 
programming concepts such as methods and how you can use them to bend your data 
to your will. And finally, you’ll instantly power up your programs with the help of library 
code. 


this is a new chapter 
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bean counter 


Your new gig at Starbuzz Coffee 

Starbuzz Coffee has made a name for itself as the fastest growing 
coffee shop around. If you’ve seen one on your local corner, look 
across the street; you’ll see another one. 

The Starbuzz GEO is always on the lookout for ways to boost profits, 
and he’s come up with a great idea. He wants a program that will 
show him the current price of coffee beans so that his buyers can 
make informed decisions about when to buy. 



丁 S-tavW 



I had a programmer do some 
work for me, but they're not 
answering their phone. They ve 
disappeared! Think you can take 
over? ril let you have the code 
they Ve already come up with. 
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textual data 


Here's the current Starbuzz code 

The previous programmer has already made a head start on 
the code, and we can use this as a basis. Here’s the existing 
Python code, but what does it do? 


rteves i\^t todt 

rts 






Take a good look at the existing Starbuzz code. What do you think it 
actually does? 
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test drive 




Tqst DriVQ 


Type the code into IDLE, save the program, and run it. 



rtcvc S ^oyr 

coAt as 
m-to IP^ 


dm 


i\\C f\ro^aw 

p\rodu£>cs 七 Wis. 


gate off aeprk^.py ~ ；h em«/b srryp/He a d FlrEtProg/cha pte r J/cod @/g 


Flip Frtil Frtrmflh Run flptinn 1 % Wmrinws 


'.c c- 1 ■ ur 11 lb. r-egue □ t 


page - arilib.regue 口 fc*urlopen http : " b_:..]n□ r u□、biz prim Sitrl' } 
Lt ： Jc.L =■ pdiytr. i. e-dil ( ^ idtrL-udtf^ M dr.£3 " J 

户,丄 eiL ( Lcf^iL ]| 




Python sh^ll 


£iIp fflif Fih^Jl J^hujg flphnn^ Winrlnwi 


Python 』， 13 ，丄 (riWlsfeHS^fc, l'e£> 

[Rf ： r ： it ^ 1J J tm 1 i nLi K ? 

Type ■copyrignt," „ M credit b" or " 1 1 cen b e() ■ tor mor© information 
>» - - - - - - -- - - UnSTAHT 




<html><hcad><titlc>Wc 1 com to the Econo 1 R s Us Pricing Pagc</title> 

^iinK reL- n stylesneet ~ type-"text/css" Jirflr-^tieanerfjfli. csb " 

</ hcod><£K?dy> 

^ti2 ^Welcome to tfte aeans' P.' Us Pricinq Paqet /H2 > 

- <p>CurrGnt price of coffee be-ana - ■< ； 3t i:ong>fr 5 _ 4 / atrongx/p>. 

cp>Prlce valid fQE 15 minutea froni 19:^2 on tredne a day 2 7 / 0 3 /2<3 09. t /p > 
< /bodyx/html> 

»> 


The code you’ve been left goes to the prices page on the 
Beans’R’Us website to get the current price of coffee 
beans. But instead of giving just the cost, it gives you all 
of the HTML text used to create the web page itself. 





Sw 办相 cs . 


40 Chapter 2 



Hey, thafs not right! I only 
need to see the current 
price of coffee beans, not all 
that other stuff. Think you 
can give me just the cost? 


















textual data 


The cost is embedded m the HTML 

Take a closer look at the results of the program. The current price 
of beans is right in the middle of the output: 



The Starbuzz GEO would find it a lot easier if you could extract 
the price of beans and just display that, rather than have to look 
for it in the HTML. But how do you do that? 


A string is a series of characters 

The output of the Starbuzz program is an example of a string. 
In other words, it’s a series of characters like this: 


匚 






SQQQ 


Somewhere within the string is the price of coffee beans. To 
retrieve just the price, all you need to do is go to the right bit 
of the string, retrieve the characters that give the price, and 
display just those characters. But how? 


You only ihese d^avatievs. 



0 囡 EE 0 回回函 00 
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offset values 


Find characters inside the text 


The computer keeps track of individual characters by using two pieces 
of information: the start of the string and the offset of an individual 
character. The offset is how far the individual character is from the start of 
the string. 



1 Uhc 七 K J ^ 
st,r,h 9 ^ wc have r^oved 

冰。 Pl^cs, -the ^sc-t is O 


□ QQ 0 I 3 Q 



QgagBggQ 


The first character in a string has an offset of 0, because it is zero 
characters from the start. The second character has an offset of 1, and 


so on: 





v ^lucs 



十 


5 




1 




1 


io 


11 B ft 


/\s y/C start 0, 

o^Ui values aUys ov>c less 

从 w actual 


The offset value is always 1 less than the position. Python lets you read a single 
character from a string by providing the offset value in square brackets 
after the variable name. Because the offset value is used to find a character, 
it is called the index of the character: 


-the c^ t i„ 
f as _十 A so we 如 vff 

b n c r hch ^ Hh 9 ^ ^ 



SQ 00 S 0 S 回 00000011] 


text 鬥 s 

text 呂 

rt-eKt 鬥 lrv 〕 

texAll 〕 
tex t【Is 
teKt【s 
texts 

tE3 

teKts 

tES 

texts 

teKts 

texts 

tES 

teKtcs 


42 


Chapter 2 










textual data 


Put how do you get at more thaw 
owe character? 


For Starbuzz, you don’t just need a single character. You need to extract 
the price from the string of HTML, and the price is made up of several 
characters. 


You need to extract a smaller substring from a bigger string. A substring 
sequence of characters contained within another string. Specifying 

dtrino'q in PvtVinn ic: a littlp likp rparlina «:ina1p r Vi a r a r tprc: from a 


substrings in Python 


index values within the 


s 


a Aara 如 T. 


Sharpen your pencil 




之 

t<r,h 3 〜佺 ihed wiihih u s w 


s [14 ； 


(Wt WludH) 如 second 


Let’s work out what each of the following substring specifications 
mean. Imagine the variable s is set to the string below. Your job 
is to determine what each of the substrings provide. 


[11000@0囡0囡0因囡00 囡 0000 


s[5:9] 


s [10:12] 


s [13:18] 


In general, if you specify a substring using s [a: b] , then: 
a is . b is .. 
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here is waldo 


«^harp€n your pencil 
i. Solution 


Imagine the variable s is set to the string below. Your job was to 
determine what each of the substrings provide. 








I 」 LlI bdJ Q Ld 

m H a . b I 午 I? a n / j« 





Watch it! 


^ 01 * 5 ^ mdc% 1 ^ 

•IS w\Cir\t>Oir\cdi \Y\ *b^C 

subs*b\rmj spc6*fita*tior\, 
\{!s r\o*t "mtludcd m i\\t 
t%bradcd subs-bv'mj. 


The second 
index value is 
after the last 
character in 
the substring 


This is even though the 
first index value is the start 
character of the substring. 
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textual data 


^harpen your pencil 


^ 


You need to update the program to extract the price starting at 
the 235th character of the string. The price is four characters long. 
Store the price substring in a variable called price. Write the 
new version of the program here: 
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extract the price 


#^harp your pencil 

Solution 


You needed to update the program to extract the price starting at 
the 235th character of the string. The price is four characters long 
and stored in a variable called price. 


i 叶 。 \rt urllib rc^uest 

fay 二 u\rllib\rc^ucs*tu^lopch( u K*t*tp : / / wwwbeahs — \r 一 us.biz/p\rides.lvbr«r) 

=■ page.readO.dedoWtfS ”） 

v/ ou stove ^ ^ fv-ife ==■ .^^2-^ ； 2.^03 

从 c V “ vav ' dWc ' U ; ) ^ 

prm 七 (prideJ 

Kov/, mstcad - a d t 

如 t” (如 e 如 W ZU aL Z?V W ai ⑽ 23 午 , 战 

輝 /(t ‘ 

t^bratitd subs 七叫 ) . 



rteve \i *«s ： tV>c sufesVma 
wtvac»*b and c.uvv"cy\*t 
IpVlC-C 0*(* 6o^cc. 
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m 


tst 【 z39 〕 


cxvetJ 

^ ^ /Sr / text — 

h XL 、 T 
$i 
^^Te 卜 

?is •二 A 
Jfed= 

2-usbe 心 


y 



text 〔 237 〕 




□ 

& 

s 




tstctvj34 〕 


text 〔 Z3a 


t 咁 xtt~sL_l 


d n 
hav-st 

AubI - 1 

il 说一 0 

114 回 Ic 

Tw.m*bk r^l 

iitext 〔 rv3s 


Ql 



tst 〔 229 〕 


f 


J SKt 1 ^;? 71—1 


texttftjzs 


tsttRSa 












textual data 


m i.D 




■I. li >. 3 ] itn 1 S niEix ? 

■copyright" F "credita" or "license() n : tor awsr© intormation, 
- RnSThfiT ————— 一 




^rom 仏 C Bca^sR'Us Y/clo ^ 


That looks a lot cleaner. Now, instead of displaying the entire 
HTML text of the web page, you’ve cut it down to just the 
piece of the string (the substring) that you need. 


Thafs great. Ifs exactly 
what I need! You have no 
idea how much time and money 
this is going to save me... 





Tqst DriVQ 


Type the code into IDLE, save the program (choose a name for 
the program that is meaningful to you), and run it. 



g etc nce2 .py - vhDmeyba.rryp/H ca d F i rstProg ^chaptR rSycade/gi^t 


□ie Lrfit rjHrnat Run Qptiafis Endows 


.r c - ： ir" urllib.request 

page — url lib. request * urlopcn j 1 ht to; / ■' ■ be ana—r- us „ biz-' pri ccs . htiriL 

test - page, read £) k decade j utf D " || 

pr icc - text [ 2 3 *3:2 3 0 ] 
print (pr 


Python shall 




File Frlit^ r.hp|l r^phuf] Hplmn^ Winrinw«i 



f r € 3 

t ^ p > > 4 - > 
y y > ^ ■ > 




















string theory 



The 

This week’s interview: 

We ask the String what it’s like 
being the world’s most eligible 
datatype. 


Head First ： String, it’s so good of you to find the 
time to speak to us. 

String: Please, the honor is mine. Sit. Sit. Make 
yourself at home. Did you eat yet? 

Head First ： I’m fine, thank you. String, where 
should I begin? You are known the world over for 
your work. In your time you’ve carried the works of 
Shakespeare, Geothe... 

String: Dan Brown. 

Head First ： ...all the great works of literature. And 
even mundane things like names and addresses. Tell 
me, how did you become so popular? 

String: It’s a question of character. Well, characters. 
See, before I existed, computer systems used to 
record text one character at a time. 

Head Pirst: That must have been rather 
inconvenient. 

String: Inconvenient? It was a royal pain in the 
tuchis. 

Head nrst: Quite. 

String: Without me, handling text was like riding a 
pedal cycle without a saddle. 

Head First: In what way? 

String: It was possible to get somewhere, but the 
journey was kind of stressful. 

Head First ： You simplify things. 

String ： Certainly. I simplify. Instead of keeping 
track of a hundred, or a thousand, or a million 
letters, you just need keep an eye on one thing. Me! 


Head First ： That’s a good point. 

String: I like to think of myself as a front. An agent, 
you might say, for all the characters I work with. 

Head First ： People deal with you, so they don’t 
have to deal with individual characters in memory. 

String ： Exactly. I’m an organizer. I keep an eye on 
the day to day business of the letters. If I need to be 
shorter or longer, I arrange for the characters to be 
made available. 

Head First: Tell me about your substrings. 

String: Ah, my substrings. Like chips off the old 
block. That a humble datatype should be so blessed! 

Head First: A tissue? 

String ： Bless you.〈blows nose>. Those boys are 
so close to me. Here’s a photo. Can you see the 
resemblance? 

Head First ： Why he looks just like... 

String: Ah, you guessed! Yes, my character 
sequence from 137 to 149. Exactly. Just like his old 
man. But shorter. Little more hair. 

Head First ： Your substrings are strings as well. 

String ： Certainly. Strings just like me. And they, I 
hope, should one day be able to produce their own 
substrings as well. 

Head First: Yet some people are confused by your 
indexing. 

String: What can I say? I started with nothing! 
Head First ： String, thank you. 

String ： A pleasure. Are you sure you ate? 
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textual data 


tJiereiare no ^ 

Dumb Questi9ns 


So, I can put any web address into 
this code and grab the associated web 
page from the Internet? 

Yes, feel free to try it out for yourself. 

Don’t I need a web browser to 
view web pages? 

Yes, to view a web page in all its 
formatted glory-with embedded pictures, 
music, videos and the like-a web browser 
is a must-have. However, if all you want to 
see is the “raw” HTML, a browser is overkill. 

What does the import line of code 
do? 

It gives the program the ability to talk 
to the Internet. The 

urllib. request code comes as 
standard with Python 3. 


Q/ And I guess that call to urlopen() 
goes and gets the web page? 

That’s right! The provided web 
address (or “URL” to use the proper web- 
speak) is fetched from the Internet and 
returned by the call to urlopen (). 

In this code, the fetched web page is 
assigned to the page variable. 

And the urllib.request bit? 

That just tells the program to use the 
urlopen () function that comes as 
standard with Python 3’s Internet page- 
reading technology. Well have more to say 
about urllib. request in a little bit. 
For now, just think how lucky we all are not 
to have to write code to fetch web pages 
from the Internet. 


I get that the call to read() actually 
reads the web page from the page 
variable, but what’s that decode(“utf8 ”） 
thing? 

When the web page is fetched from 
the Internet, it is in a “raw” textual format. 
This format can be a little hard for humans 
to read. The call to decode () converts 
the raw web page into something that looks 
a little easier on the eye. 

To see what we mean, try removing the 
call to decode () from the program and 
running the code again. Looks a little weird, 
doesn’t it? (Don’t forget to put the call to 
decode () back in before continuing.) 


BULLET POINTS —— 

■ You can download the HTML of a 
web page as a textual string. 

■ A string is a sequence of characters. 

■ You can access individual characters 
in a string using an offset. 

■ The offset is known as the index 
value of the character (or just index 
for short). 

■ Strings within strings are called 

substrings. 


Substrings are specified using 
two index values—for example: 

text[10:20]. 

The first index value is the location of 
the first character of the substring. 

The second index value is the 
location after the last character of the 
substring (up to, but not including). 

Subtract the second index from 
the first to work out how long the 
substring should be. 
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change of address 


Peans'R'Us is rewarding loyal customers 


The CEO just got great news from the beans supplier. 


The supplier is so happy 
about all the business were giving 
them that they are going to make . ^ 

us members of their loyalty discount 
program. They say it should be a 
simple fix. Can you look into it? 


The supplier actually maintains two prices: one for regular customers 
and one for loyalty program customers. The different prices are published on 
different web pages: 

Rcjulav- ^us*bomc\rs 

七 heir http : // www. beans-r-us . biz/prices • html 


^°X>wcv-s http: / / www.beans-r-us .biz/prices-loyalty.html 

V>cvc- ^ 


That means you need to change the web page address in the code: 




Let’s run it to make sure everything works OK. 
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textual data 



Tesr DriVq 


This time when you run it, this happens... 



The program is no longer displaying a price. So what happened? 


The price moved 


The web page for loyalty customers is much more dynamic that the old 
web page. The page for regular customers always displays the price in a 
substring beginning at index 234. That’s not true for the loyalty program 
web page. The price on that page can be almost anywhere. All you know 
for sure is that the price follows the substring >$: 








You need to search for the price string. 
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searching for substrings 


Searching is complex 

You already know how to find a substring, so you could run through the 
entire web page and check each two characters to see if they match >%, 
like this: 


6ould *bWou^ 

sbc\v\^ (or KK >f \ Ids 
a-t Z cMaracitrs at a 七 k 







Wve 4uhd u > 



You could do it this way... but should you? 



So tV^csc 七今 

dhavat 七 cvs must be 
i\\t y ， 6c, 七？ 


There’s a lot to worry about. Which two characters are you currently 
comparing? Where in the string are you right now? What if “ >$” isn’t 
found? Searching for substrings in strings is a little more complex than it 
first appears... 


But if you don’t want to write code to search the 
string, what else could you do? 
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textual data 



Wouldnt it be dreamy if there were 
a simple way to search a string for a 
substring? But I suppose thafs just a 
fantasy... 
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smart data 


Pythow data is smart 


The more code you write, the more you will find that you need to do the 
same kind of things to the data in your variables all the time. To prevent 
you from having to create the same code over and over, programming 
languages provide built-in functionality to help you avoid writing 
unnecessary code. Python data is smart: it can do things. 


Let’s look at an example. 

Imagine you have a piece of text in a variable that you want to display in 
uppercase (all CAPITAL letters): 


msg = "Monster truck rally. 4pm. Monday. 11 


You could write code that read through each character in the string and 
printed out the matching uppercase letter. But if you’re programming in a 
language like Python, you can do this: 


TV^c Aoi 州咖 s ” 

print 



uppcvO' is a s-tHhj method. 


upper()) 


MONSTER TRUCK RALLY. 4PM. MONDAY 


displayed, the value op 
the vaHablc i h 

UPPERCASE. 


But what does msg. upper () mean? 

Well, msg is the string containing our piece of text. The . upper () that 
follows it is called a string method. A method is just an instruction for the 
string. When you call msg . upper (), you are telling the string to give 
you an UPPERCASE version of its data. 

But is there a string method that can help you search 
for a substring within a string object? 
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textual data 



■f 


+ 


• + 


These are some of the many built-in string methods that come with 
Python. Match each method to what it does. We’ve done one for you 
already. 


Mediod 


text.endswithC.jpg") 



Wh^tt ihe method does 


Return a copy of the string with all occurrences of one 
substring replaced by another. 


Return a copy of the string converted to lowercase. 


Return the value True if the string has the given 
substring at the beginning. 

Return the value True if the string has the given 
substring at the end. 

Return the first index value when the given substring is 
found. 


Return a copy of the string with the leading and 
trailing whitespace removed. 


Return a copy of the string converted to uppercase. 


^Sharpen your pencil 


Which of the above methods do you need to use to locate the 
price substring within the Beans’R’Us web page? 
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find, the right method 





-4 - k ▲ 




These are some of the many built-in string methods that come with 
Python. You were to match each method to what it does. 


Method 



WK^ttKe method does 


Return a copy of the string with all occurrences of one 
substring replaced by another. 


Return a copy of the string converted to lowercase. 


Return the value True if the string has the given 
substring at the beginning. 

Return the value True if the string has the given 
substring at the end. 

Return the first index value when the given substring is 
found. 


Return a copy of the string with the leading and 
trailing whitespace removed. 


Return a copy of the string converted to uppercase. 


^.Sharpen your pencil 

Solution 


Which of the above methods do you need to use to locate the 
price substring within the Beans’R’Us web page? 


The method 
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textual data 




E«RciSe 


You need to update your price-grabbing program so that it extracts the four-character substring 
that follows the occurence of the “ >$” characters. Write the new version of your code in the 
space provided. 

Hints: Don’t forget that the find () method finds the starting position of a substring. Once 
you’ve found “>$ ”， use Python’s addition operator to calculate where in the string you want to 
extract the substring. The addition operator is the “+” symbol. 


t owV) < 

f ~^ - 、 

coffee beans = <strong>$5.49</ 
strong></p><p>Price valid for 


/ ou ^ really 
,0 〜“ 
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finding the deal 



E^eRciSe 


You needed to update your price-grabbing program so that it extracts the four-character 
substring that follows the occurence of the “ >$” characters. 

Hints: Don’t forget that the find () method finds the starting position of a substring. Once 
you’ve found “>$ ”， use Python’s addition operator to calculate where in the string you want to 
extract the substring. The addition operator is the “+” symbol. 


u\rllib vc^ucs*t 


This todt 


pay 二 urllib v-c^ucs*t uv*lopcr\( u h*t*tp : / / y/y/y/.bcahs-\r-us.biz/j>ridcs.h*t^l 
*twt 二 pay rcadO.dcdodcOu-t-fS^) 


h . 

° c ^ 乙。 … katioh. ^^y/hcrc =■ 


TV^is »s i\\t addition 

"The sta\rt of the adiual 
is ahothc\r Z ihdex positions 

aloh 9 ^ s 七 〆… 3, while the Chd 
the p\rific is aho-thev 



s*ta\rt o-f pride 二 where + Z 
Chd pride 二 s*ta\rt c^f pvidc 

• • • • • ••■••••• •參 •••••••• »•••••• 



Pride =■ *tc%*tCs*ta\rt o-f P\ridc ： Chd o-f P\ride3 

• ••雖 •••• •參 •••••••••••••• I •拳拳 •••••••• ••争 •••••••• 


pvin"^iride) 

Did you v-emei^bev" -fco 
fHht out the 

you’d -Pouhd it? 



I/Vrth *thc s*tav-*t av>d c^d mdc% 

lota 七 I 。灼 s \CY\o^iy\) rt’s easy *to 
spcdi-fy 七 he subs*tv*m^ vc^uivcd- 
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textual data 


V%! r —> 


Tesr DriVq 


OK, so your program should now be able to find the price, no matter 
where it appears in the page. 


prito3. py - ilHaad First I'piittoltosi] rk 


Fill - £dit FjjrniiaL R^cin Q | aLii 3 ir.. W^induw 1 


rr-^i " Kir| I i ti b Jit 

page ■ HirlliJb^request - urlope-nf n http : 
teset — pfl 4 r^fl ^i{} - rifffiiiirtiff ( n u t, f H " |j 

wtier 章 - text • f ind ij B >5 ■ Jl 

vLa.r± c:b 言 wh^Lm + 2 

rnu1_nr_jir I cm • Fitfl.rt._of _^pr i cfl 1 4 


pr ■ lejtt [ si az 2 ejail_jql 

print (price) 


ntw. -r- ua I biz:/prici 



.Qy-alty + b tm 


1/cirsioh 3 o*f 

y° u,r p^ogv-a^ 



TV^c 

t%{xacitA 
七 k lavyv- stv'm^ 
HTML 


It works! By adding very little extra code, you have made the program 
much smarter and more useful. 
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frugality feature 



The new version of the program works, but 
now there’s a design issue. 

The Starbuzz GEO wants to know when the price of 
the beans falls below S4.74. The program needs to keep 
checking the Beans’R’Us website until that happens. It’s 
time to restructure the program to add in this new feature. 

Let’s add a loop to the program that stops 
when the price of coffee is right. 
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textual data 


飞 Code Magnets 


The program code to add the feature is sitting on the fridge door. 
Your job is to arrange the magnets so that the program loops until 
the price falls to $4.74 or lower. 
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Code Magnets Solution 

The program code to add the feature was sitting on the fridge door. 
You were asked to arrange the magnets so that the program loops 
until the price falls to $4.74 or lower. 


import urllib.request 

^^^rice^^^99^99^^J| 

1 

while price > 4 

.74: | 


P，d 7 。认 I 

vcwcwbcv 」 
mdcv't 

ThcY ave 
ms'ide 
loo\>. 



end_of_price = start_of_price + 4 


price = text [start_of__price : end_of_price] 


TW»s Vmc sV^ould^t 
fee as its 

o^At loo?- 
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textual data 



Tesr DriVq 


Enter the new version of the program code into an IDLE edit window and 
run it. 


getcoffeeprkc4_ py - iliomcyba rryp^NeadrirslP rog .'ch flp(er2/£odt/g4teoffeepri£e4.py 


uxll il]U t 


price _ 5Ui95 




WtYtS youv 
pv-ogvam code 
typed ih-to 

IDLB. 


，， prlca > 4 : 

paqe 匿 urllib.. reqve a t , UFlopcn( " int cp: / /ww. be anm -t-u3 . bi?/prlc«B * loyalty , Jitn] 
LkjcL ■: pa^c * £ ead [ J . limr^xlier f u -j L f F' ~ ) 


vhn rr - t r-xt. - f i rirf f r ' 


atMt_ot_price - 
orm_oE^prico # 


Python 5hal 


pr icie ■: L?jc1l| sL-ox IL ci. 

print ( "Buy !" } 

I 


gilp [rift Shp|l ^hugi QptiDn^ ^inridw^ 


MPlp 


M tW»s? 


Python J.Q.L I? 2DQ9 P IS: 11:3?) 

|GCC | on llnux2 

Type "eopyright", _erflditfl_ or ■licflciBfl ( ) ■ for nore inf Donation. 

MMBH B B EIS ■ ■ B B B H£ START ■ B B ■ ■ ■ B ■ ■ KB HKKKSBIBI 

TraLrebaR-lL || [zia3<L retreaiL icall l-aa L ) : 

File "/DcjcrenieiaLa/'cjif Lcu-CfeepE -PV* r 3 p in <raocIu.Ie> 

wh lift pr i fir ： > 4 A 1*4 » 

Typff-Errcir i unorri^r Ah 1 ^ t ypr-.n fltt r | ) > f lomf: ( J 

»> I 


Ul ： ID col ； 4 


It looks like something’s gone wrong with the program. What does 
TypeError mean? What’s happened? 





Look at the error message in detail. Try to identify which line in the code 
caused the crash and guess what a TypeError might be. Why do you 
think the code crashed? 
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type differences 


Strings and numbers are different 

The program crashed because it tried to compare a string with 
a number, which is something that doesn’t make a lot of sense 
to a computer program. When a piece of data is classified as a 
string or a number, this refers to more than just the contents of the 
variable. We are also referring to its datatype. If two pieces of 
data are different types, we can’t compare them to each other. 



Think back to the previous chapter. You’ve seen this problem before, 
back when you were working on the guessing game program: 


TW»s vav\aWc W»ll be 9 'y 

set to a I 

guess = int (g) 

- ass\ycd -to ^ css - 

In the guessing-game program, you needed to convert the user’s guess 
into an integer (a whole number) by using the int () function. 

But coffee bean prices aren’t whole numbers, because they contain 
numbers after a decimal point. They are floating point numbers 
or floats, and to convert a string to a float, you need to use a 
function other than int () . You need to use float () : 


tow-tam a dc 心 al 
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textual data 



Tesr DriVq 


This should be a pretty quick fix. If you use the float () function to 
convert the price substring, you should then be able to compare the 
price to 4.74: 


L 


gctcoffecprlc -/h omc/ba rryp^H &adHrstProg/ch dc/gctcoffccprkG 4 . 


EdiL FynTidL Run OpLimi!] Wimiuw^ 


. : ux 11 丄 b ■ z. a L 

price ^ 99.99 

price > 4i71: 

paq© — ur 11 ib. request. urlope n _ " hx. i p 
■hrxh — pngrt. rr-.nd ( ) *r3KirnrIr ^ "nrf " J 

^hd.ifc ： s Lt:x1_ * j 1 ) 

atart_Dl_price — wiiere +2 

triid ul pi. Ittr = a Lcir L uf [ji. + 1 


price ^ O.-0-at ^ ts«r [ start of pries i end of prlcs| ) 


.ww, tsaaria-r-ua „ bla/prlcea-loyaliy .ficinl" ^ 


print { " bay! r, ) ^ 



The plrogira^ 浐 Uhs 

witK ho problems 
this -time. 


J 



TV^c ^dated toAt 



you are here ► 


That’s much better. Your program now waits patiently until the 
price falls to the right level and only then does it tell the GEO that 
the time is right to buy a fresh batch of coffee beans. 


This is great! Now I can get on with 
the rest of my day and I only hear 
when the price of beans drops to the 
right level. This'll save millions! Til tell 
every outlet to use it worldwide. 
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the DEPARTMENT of WEBLAND SECURITY 
^NOWWHBKBWB (BUT WB KNOW 
■ 2 &V 5 WHERE YOU LlV ^ r 

泛 WASHINGTON, D-C ， 


^ nf W ebland Security 


To Whom It May Concer Distributed Denial 

,. nn in to an apparent biz domain 

^ recent 一 in = 

◦ f Ser d V Sat much of the traffic 肛。一 the world, 

showed tha Starbuzz outle reached a peak of 

l0Cat ber of web transactions (wlaxc^^^^ resul ted xn 

The nU ! imdL red thousand request resultin g in a 

several hu ^ BeanS ， R’Us servers, 

a eras o of business. 

significant 1 this office 

.. h the powers invested i ^ ale rting the 

in accordance ^ attorney Genera f this kind of 

thin9 * Bud consider yourself on notice. 

we , re watching you, Bu . 


Yours 


faithfully^ 


Head of internet 


That sounds weird. What happened? 


Chapter 2 


textual data 


The program has overloaded 
the Pcaws'R'Us Server 

It looks like there’s a problem with the program. It’s sending so many 
requests that it overwhelmed the Beans’R’Us website. So why did that 
happen? Let’s look at the code and see: 

import urllib.request 
price = 99.99 
while price > 4.74: 

page = urllib.request.urlopen("http :// www.beans-r-us.biz/prices.html") 
text = page.read().decode( M utf8") 
where = text•find(、>$') 
start_of—price = where + 2 
end—of—price = start_of—price + 4 
price = float(text[start_of 一 price:end—of 一 price]) 
print ("Buy!") 


Wcvc S the Codt 
'"t ^uv-v-Chtly 
siahds. 



If the value of price isn’t low enough (if 
it’s more than 4.74)，the program goes back 
to the top of the loop immediately and sends 
another request. 

With the code written this way, the program 
will generate thousands of requests per 
hour. Multiply that by all the Starbuzz 
outlets around the world, and you can start 
to see the scale of the problem: 


You need to delay the pricing 
requests. But how? 



TV>c Bcay\s ^ Ws 
scV'VCV' 

all \rc<\ucsts. 


you are 


here ► 
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Time... if only you had more of it 

Just when you’re feeling completely lost, you get a phone call 
from the Starbuzz coder who wrote the original version of 
the program: 


x 



It seems that she can’t get back because of a storm in the 
mountains. But she does make a suggestion. You need to regulate 
how often you make a request of the Beans’R’Us web server. One 
way to do this is to use the time library. This will apparently 
make it possible to send requests every 15 minutes or so, which 
should help to lighten the load. 

There’s just one thing: what’s a library? 
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textual data 


You're already using library code 

Look at the first line of the original code: 



This ihai wc 


The import line tells Python that you intend to use some library code 
called urllib . request. A library is a bunch of prewritten code that 
you can use in your own programs. In this case, the urllib . request 
code accesses data on the Web. This is a library that comes as standard with 
Python. 

To see how the code is used, look at this line: 



Libv*avy 


70U 

成 m 7 祕。娜 V 呼 a 


The code that follows the = sign is calling a function in urllib . 
request called urlopen () . Notice how we say we want the code: 
urllib . request, followed by a then the name of the function. 




But how will the time library help us? Let’s see... 
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find the time 



E%GRClS€ 


These are some of the functions provided by Python’s built-in time library: 


Python Library Documentation: 


time 


time * Cl T °, C e k current t.me xn sec —, 抑卽心 floating 
point number. 

time.daylight () vou are not currently in 

This returns 0 it you 

Daylight Savings Time. 

current UTC date and time (not affected 
by the timezone). 

time. localtime () ] t ime (is affected by 

Tells you the current local t.im 

your timezone). 

time. sleep (secs) ^ ^ qnecif iecL number of 

Don't do anything for the specinea 

seconds• 

time.time () ^ ^ o Pr0 nds since January 1st, 

Tells you the number of seconas 

1970. 

他 number of hours difference between 
your timezone and the UTC timezone (London). 


You need to use one of these functions to help you fix your code. 

But which one? Draw a circle around the function you think you might need. 
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textual data 


With the appropriate function identified, amend the code to control how often the request for 
the web page is sent to the server. The Beans’R’Us webmaster has been in touch to say that 
their web-based pricing information is updated every 15 minutes. Fill in the blanks in the code 
as indicated by the dashed lines. 

Hints: 15 minutes equates to 15 multiplied by 60 seconds, which is 900 seconds. Also: to use 
the functionality provided by a library, remember to import it first. 


import urllib.request 


price = 99.99 
while price > 4.74: 


page = urllib.request.urlopen("http :/ /www.beans-r-us•biz/prices•html n ) 
text = page.read().decode("utf8") 
where = text.find( 1 >$ ! ) 
start—of—price = where + 2 
end—of—price = start—of—price + 4 
price = float(text[start—of—price:end—of—price]) 
print ("Buy!") 


you are here ► 
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time is on our side 



ExeRciSe 
Solution 


These are some of the functions provided by Python’s built-in time library: 


Python Library Documentation : time 


time * Cl T °, C e k current t.me xn second 弘卿郎 a floating 
point number. 

time.daylight () vou are not currently in 

This returns 0 it you aL 

Daylight Savings Time. 

time .gratimeO^ Qurrent UTC date and time (not affected 
fc>y the tiinezone). 

time. localtime () n nral time (is affected by 

Tells you the current local 

^riezone). 


time. s 


your 


leep(secs) 


Don’t do anythAng 


for the specified number of 


TW、s looks 

l\kc best 

*to use- 


time, time 0^ ^ ^ number of seconds since January 1st, 
1970 • 

the number of hours difference between 
your timezone and the UTC timezone (London). 


You need to use one of these functions to help you fix your code. 

But which one? You were to draw a circle around the function you thought you 
might need. 
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With the appropriate function identified, you were to amend the code to control how often the 
request for the web page is sent to the server. The Beans’R’Us webmaster has been in touch 
to say that their web-based pricing information is updated every 15 minutes.You were to fill in 
the blanks in the code as indicated by the dashed lines. 

Hints: 15 minutes equates to 15 multiplied by 60 seconds, which is 900 seconds. Also: to use 
the functionality provided by a library, remember to import it first. 



pyo(\yaw access w 

切減如 1,Wa ” 



import urllib.request 

inafovt 



page = urllib.request.urlopen("http :/ /www.beans-r-us•biz/prices•html ▼▼) 
text = page.read().decode("utf8") 
where = text.find( 1 >$ ! ) 
start—of—price = where + 2 
end—of—price = start—of—price + 4 
price = float(text[start—of—price:end—of—price]) 
print ( M Buy!") 


you are here ► 
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coffee all around 


Order is restored 

Starbuzz Coffee is off the blacklist, because their price-checking 
programs no longer kill the Beans’R’Us web server. The nice 
people at Webland Security have, rather quietly, gone away. 

Coffee beans get ordered when the price is right! 
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Your Programming Toolbox 

You’ve got Chapter 2 under your 
belt. Let’s look back at what you’ve 
learned in this chapter: 


Proyaww— Too\s 

c , . ftS a , e 爭奶 j -dW'dual •如 

* |_咖加士 a i c 丄 

一： : 二《。，丨 
? 代一 w—n ^ ave a 1 

* As .eil as ^ a vaWe, data p ； 1 

"data bi^ rytllOh Tools 


氺 S*br 、 呼 


氺 、 s a 如 ^ 3 切 ? c 

氺 *»s a data 



(up 


c variable "s w 

*^d() ^^hod u s ea ^ 5 ^ ih9s 

^PBRCASB^ ^ io 

决 + addi*tioh opdaW 

> 9 ^^^ oycraijoy' 

“y W— 4 daWw 

^_ 


you are here 
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3 functions 




LeVs get organized 


w 



As programs grow, the code often becomes more complex. 

And complex code can be hard to read, and even harder to maintain. One way of 
managing this complexity is to create functions. Functions are snippets of code that 
you use as needed from within your program. They allow you to separate out common 
actions, and this means that they make your code easier to read and easier to maintain. 
In this chapter, you’ll discover how a little function knowledge can make your coding life 
a whole lot easier. 
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emergency option 


Starbuzz is out of beans! 


The Starbuzz buyers love the program you created in the 
last chapter. Thanks to your efforts, the Starbuzz CEO 
is only buying coffee beans when the price drops below 
$4.74, and his organization is saving money as a result. 

But, now there’s a problem: some Starbuzz outlets have 
run out of beans. 


We have a worldwide crisis! Weve 
run out of coffee beans in some of our 
stores, and weve lost some customers, too. 
My buyers are only buying coffee when 
the cost is low, but if we run short on 
coffee supplies, I’ll pay any price. 


When the coffee beans start to run low in an outlet, 
the Starbuzz baristas need to be able to send an 
emergency order to the GEO. The outlets need 
some way of immediately requesting the purchase of 
coffee beans at the current price, regardless of what 
that price is. They also need the option of waiting for 
the best price, too, just like in the current program. 

The program needs an extra option. 
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functions 


What does the new program need to do? 

The new program for Starbuzz needs to give the user two options. 

The first option is to watch and wait for the price of coffee beans to drop. 
If the user chooses this option, the program should run exactly as it did 
before. 

The second option is for the user to place an emergency order. If the user 
chooses this option, the program should immediately display the current 
price from the supplier’s website. 


r ^harpen your pencil 


Here's the existing code for Starbuzz. You need to modify the program 
to add an emergency report feature that will immediately report the 
current price. Which parts of the code can you reuse to generate the 
emergency report? Grab your pencil and circle the part of the code you 
think you might reuse. Why do you think you’ll need to resuse this code? 


import urllib.request 
import time 

price = 99.99 
while price > 4.74: 

time.sleep(900) 

page = urllib.request.urlopen("http :// www.beans-r-us.biz/prices.html") 

text = page.read().decode( M utf8") 

where = text.find('>$') 

start_of 一 price = where + 2 

end—of—price = start_of—price + 4 

price = float(text[start_of—price:end—of—price]) 

print ("Buy!") 


you are here ► 
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reuse code 


Sharpen your pencil 

Solution 




Here’s the existing code for Starbuzz. You needed to modify the program 
to add an emergency report feature which will immediately report the 
current price. Which parts of the code can you reuse to generate the 
emergency report? You were to circle the part of the code you think you 
might reuse as well as state why you might need to reuse it: 


import urllib.request 
import time 

price = 99.99 
while price > 4.74: 

time.sleep(900) 


Hcv-cs Code you 

VCUSC- 


urllib.request.urlopen("http :// www.beans-r-us.biz/prices.html") 
page.read().decode( M utf8 M ) 



page : 
text : i 
where = text.find('>$') 
start_of—price = where + 2 
end—of 一 price = start_of—price + 4 
price = float(text[start of price : end of price]) 


print ("Buy!") 


you wait ^ ih c 

OY ay, 

二⑽ y 。咖 

仏 s 亡 0 de ih 從 h case. 
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Does that mean we have to 
duplicate the code for each 
option? Is this a good idea? 


If you just copy and paste the same code ， 
it could make your program very long. And 
hard to maintain. That’s why you don’t want 
to duplicate the code. 


IrnajmC i-f Y ou 
V^ad *to tamtam a 












functions 


Pow’t duplicate your code. 


When you need to add a new feature to a program that’s similar to some 
other code in the program, you might be tempted to just copy and paste 
the code. 

In practice, that’s actually a pretty bad idea, because it can lead to code 
bloat. Code bloat means that you have more code in your program than 
you actually need. Your programs will get longer, and they’ll get a lot 
harder to maintain. 



p w 以二 : 

m \ot5 V 


vCVS. 


Heres the printout of the tic-tac-toe 
game. If you really want me to change the 
colors of the crosses, ril just need to replace 
the code that displays each of the 9 squares. That*s 
the same code in 9 different places. Oh, and if you 
want me to change the Os... 


.Reuse your code instead 

Programming languages all come with features that allow you to reuse 
code. So what’s the difference between copying and reusing code? 

If you copy code, you simply duplicate it. But when you reuse code, you 
have a single copy of the code that you can call in all the places that 
you need it. Not only will your programs be shorter, but it also means that 
when you amend code, you will need to change it only once and in one 

place only. 



So you want a new gravity-bomb 
launcher added to each of the 
star-fighters? No problem, ril change 
a few lines of code and every craft in 
the fleet will be updated. 


O ^ 


So code reuse is a good thing. But how do you do it? 



you are here 
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define your function 


Reuse code with fuwctiows 

Most programming languages let you create reusable, shareable code with 
functions. A function is a chunk of code that you separate out from the 
rest of your program, give a name, and then call from your code. 

Different languages have different ways of creating functions. In Python, 
use the def keyword to define a new function. Here’s some Python code 
that defines a make smoothie () function: 

TV^c ? avc^cscs avc 
^ so be suve ^ mdludc 七 km. 


A 、 s a c 

vcvAsaWc 

Sx 


the -Puhd-tioh a hdr^e- 





TV^c toAt 
^ova sV^avc _ 



def make_smoothie () : 

juice = input("What juice would you like?") 
fruit = input("OK - and how about the fruit?") 
print("Thanks. Let's go!") 
print("Crushing the ice... 
print("Blending the " + fruit) 

print ("Now adding in the " + juice + " juice ，，） 
print("Finished! There * s your " + fruit + " and 


In Python, it’s important that you define the function before you use it, so 
make sure the code that calls (or uses) the function comes after the definition 
of the function: 


Call the 
-Puhd'tioh. 
I^oie the 

use o-P 
pav-ChS. 



〆 


〆 









Every time that Python sees make_smoothie () in the code, it jumps 
to the code in the make_smoothie () function. It runs the code in the 
function until it gets to the end, and then returns to the next line in the 
code that called it. 


一如 A '。 

〆、& 6oAc . 


Let’s use functions to share code within your program. 
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functions 



Code Magnets 

Before you amend the existing coffee bean program code, let’s 
see if you can create a function to display the current bean price. 
Rearrange the magnets in the correct order to create the function: 


sT 




page = urllib.request.urlopen("http : //www.beans-r-us.biz/prices.html 

text = page. read () • decode ( n utf 8 ▼▼) 

where = text.find('>$') 

start—of_price = where + 2 

end_of__price = start_of_price + 4 






□ 
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order matters 



Code Magnets Solution 

Before you amend the existing coffee bean program code, let’s see 
if you can create a function to display the current bean price. You 
were to rearrange the magnets in the correct order to create the 
function: 


You st.ll bo 

before us'm^ 七 W … a fwrX 七跡 



T\\t 

s*tav-*b 


TV^C body 

r\ccds *bo be mdc^*tcd- 一 〉 


y°^ a doloh afiev 

the -Puh^tioh hdme. 





page = urllib.request.urlopen("http : //www.beans-r-us.biz/prices.html 

text = page.read().decode( M utf8 M ) 

where = text.find('>$') 

start_of_jprice = where + 2 

end_of_price = start_of_jprice + 4 


TV>c -fuy\t*b>oy\ weeds 
\p fee dcfi.Uv'cd 
fecW 心 tailed. 


print( I text[start 一 of_price:end—of 一 price] 



TV>c -fuy\t*b>oy\ 
dc 》 m • 七 o” cv^dis hc\rc. 




This li he ish'-t ihdeh-ted ； 
because i-fc is pav-t of 
"the maih pvogvam. 


Always get things in the right order 

When it comes to functions, the order in which you do things 
really matters. The get_price () function needs to be 
defined before you call it. And because the function relies upon 
some code in the urllib . request library, you need to make 
sure that the import line appears before the function, too. 

Let’s see if your new code works. 







sKo'Mffr 


T^c ovdev" \y\ >wWiA 
you do 七 Wmy is 
v-cally 
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Tqst DriVQ 



Type the code on the opposite page into IDLE, and run it to see what 
happens: 


^honite/ba rryp/h udd First P ro^/chap ler3/code/^e(p rke.py 


Fil't £JiL Foi mdl Rjuih Optiun^ WiifciJuw^ 

: n.p : r - urllibh request 

lh- I LJI-rl. nr Si ： E-! ( J E 

page = urllib. reqaeat.urlopen( "Http: / /www.beanH-r-us,biz/prices ^html 
text ， paqe.re ad[].decode ^ n ut t - ' 
where - tcjtt ■: f ind < n >S n J 

»t.r«r I. ekF_£ iritiK = wlirrrrr 十 3 

end ol price ™ start or price + a 
pc j.nt (t e^t I b taxt oJt price send ol price | 



get_price 《 


l^hch "this todt v~uhs ； 
the plri^c is displayed 
^' 9 ^ away. (Noie: you 
wy see a di-fWh-t 

pv~i 以 whch you iruh youv- 
Code.) 7 


The price appears immediately. You now have a function that reads the 
contents of the page from the supplier’s website and prints out the price 
information. 

You can reuse the function in lots of places in your program simply by 
calling the get_price () function. Now all you have to do is modify 
your existing program to use the new function. 





Look back at the original program at the start of the chapter. You know that you 
can use this function to produce emergency reports. But it will also need to 
replace the existing price-watch code. Is there a problem? Why? Why not? 


you are here ► 
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limits of print 


Your code prints out the price. Big 
deal. Ifs just a pity you actually need 
to GET the price and USE it. Your code 
isiVt much use, just printing out the 
price like that, is it? 


Functions are great for reusing code，but they 
really come into their own when they perform 
an action for you，then give you back some 
data to use in whichever way you want. 

The current version of the get_price () function prints out 
the price of coffee beans every time it is used, or called. This 
is OK if that’s what you really want it to do. The trouble is, you 
need the function to give you the price so that you can then 
decide what you want to do with it. 



discount 


0 . 


print("The discounted price is:") 
price = get_price() 
actual price = price * discount 
print(str(actual price)) 



-ruh^-tioh. Evch the 
tells you a liUle 
about what it does. 
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functions 


Return data with the return command 



If you use the return () command within a function, you can send a 
data value back to the calling code. 


import urllib.request 


def get_price() : 

page = urllib.request.urlopen("http : //www.beans-r-us.biz/prices.html 

text = page. read() .decode ( M utf8 M ) _ .. . .11 \ 

where = text, find('>$') Remove the 6311 to 

start_of_price = where + 2 y w ^riy\ 七 (）... 

end_of_price = start_of_price + 4 

print (text 


return(text[start_of_price : end_of_j>rice]) 


..ahd v'cylau \i with a 

匕 all ■(» VcWhO w ihstcad. 



TV value assi^cd -to V •说 

* |S * 7 .^ 1 . T\\t 

a^tev ： i\\t codt m 

七 he c^ctutcs. 
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don't repeat yourself 


thereiore no o 

Dumb Questions 


The return() command is just like print(), except nothing 
appears on screen, right? 

Well... sort of. The print () command is designed 
to display (or output) a message, typically on screen. The 
return ( ) command is designed to allow you to arrange for a 
function you write to provide a value to your program. Recall the 
use of randint () in Chapter 1: a random number between 
two values was returned to your code. So, obviously, when 
providing your code with a random number, the randint () 
function uses return ( ) and not print (). In fact, if 
randint () used print ( ) instead of return (), it 
would be pretty useless as a reusable function. 

So, it’s a case of return() letting a function give you 
something back? 

Yes, that’s it, exactly. 

I’m not sure I’m convinced about using functions. Isn’t 
using copy’n’paste quick and easy? 

No, using copy’n’paste is quick and dirty, with the emphasis 
on the “dirty.” When you need to repeatedly use some code ， it’s 
always better to create a function to contain and name that code. 
You then call (or invoke) the function as needed. If you later decide 
to change how the repeated code works, it’s a no-brainer to change 
the code in the function once. If, instead, you “quickly” performed 
copy’n’paste five times, that’s five changes you now have to make, 
and the chance of you missing one change or making a mistake are 
actually pretty high. So, don’t copy’n’paste! 

So, using a function lets you share the repeated code in 
a controlled way? 

Yes, it does. There’s also a guiding principle among 
prgrammers known as DRY: Don't Repeat Yourself. Using functions 
lets you keep your code DRY. 


What happens if the function omits the return() 
command? Does each function have to have one? 

No, the use of return () is not required. In fact, the 
current version of your get_price () function doesn’t use 
return ( ) at all. But, your function feels like it gives you 
something because it prints the current price on screen. When the 
return () command is omitted, a function returns a special no 
value. In Python, this value is called None. 

So, just to be clear, using return() is optional? 

Yes, it is. 

Does return() always come at the end of the function? 

Usually, but this is not a requirement, either. The 
return () can appear anywhere within a function and, when it 
is executed, control returns to the calling code from that point in the 
function. It is perfectly reasonable, for instance, to have multiple 
uses of return () within a function, perhaps embedded 
with if statements which then provide a way to control which 
return ( ) is invoked when. 

Can return() send more than one result back to the 
caller? 

Yes, it can. return ( ) can provide a list of results to the 
calling code. But, let’s not get ahead of ourselves, because lists are 
not covered until the next chapter. And there’s a little bit more to 
learn about using return () first, so let’s read on and get back 
to work. 
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^Sharpen your pencil 


Using the new get_price () function, write a new version of the 
price-checking program that does this: 


1 • Ask the user to indicate if the price is required immediately (Y/N). 


2. If the user chooses "Y〃for "yes,"find the current price and display it 
on the screen. 


3. Otherwise, check the price every 15 minutes until it falls below 
$4.74, then (and only then), display the price on screen. 
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buy it now 


t^harp your pencil 

Solution 


Using the new get_price () function, you were asked to write a 
new version of the price-checking program that does this: 


1. Ask the user to indicate if the price is required immediately (Y/N). 


Youv- to&t way 1°°^ a 1* 七七 f 
d'iWcv-cy\*b s 

0^ h as ^ ^ 0CS s3mC 

七 Wm% youVc do'm^ f me. 


2. If the user chooses "Y” for "yes," find the current price and display it 
on the screen. 

3. Otherwise, check the price every 15 minutes until it falls below 
$4.74, then (and only then), display the price on screen. 

impov 七 urllib rc^uest 

impo\rt *tirwC 


dc-f gc*t_j>y*idcO ： 


pay 二 u\rllib \rc^ucst uv , lopch( u h*t*tp : / / www.beahS-\r-us.biz/p\ri6es.h*W") 
=■ fay.readO.dedode(Vtf0 ”） 
where : — *te 此 * fmd( l >〆 ） 


sta\rt^o^^5>\ridc =■ where + Z 
e^d o-f pride ― s*ta\rt pride + 午 

\rc*tu\rh -floa*t^*tc%*tCs*ta\rt o-f P\ridc：Chd o-f PridcJ) 

i******* •• 參 !••••••••••• _>••••»•«•< 


You heed -to ask the usev t " 

the pv'uic is v*e^uiv*ed pnQ 一的 ow 二 *mJ>u*t^ U Do you warrt 七 。 see *the pride how ( 劍 ?:? 

“ tc| y. ： . =v :, . 

i+ p\ridc__hoy/ - Y : 


lUk ⑽ looses T. a»s ? la 7 
払 c value 从 at 如 
^\AV\Chor\ Y ou - 

pr!fdH 


else ： 


ir fl while pvidc > 午 .7 午： 

M* the usev d^id« io wait . 

the piri^ -to 〜 op, gei ihe p 咖 h^t sltc^OO) 

二 ， ^ Wtio. L . ，’、 

thch use the giveh value io > pride 二 
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functions 




Tost DriVq 


See what happens when you run the new program. Make the required 
changes in IDLE and take your new program for a spin: 




iirryp/Hc^eiPir^t Prngi/ 仁 h a pf Esr3 H r E Didca/^D-tpric c2_p y 


tile 氣 dit format I 5 un aptiwK 巡 indow& 


c ■ url lib 1 «i ismucEi L 

iiifHj: ■- Lime 

d»e* qet 一 pricrei| 31 

prtqr - ur L1 lEii.t - urlnp^nf "ht fp: - *■ 

EftTi 1 !: — p 作 i| t ii *■ t m ] 

«p Eftrt.. f i nrt ( * «?■£ 1 ji 
atart ut pz;lcc « vhinrc- ^ 2 
#cid ot price « Rtart of prlca ^ 4 
d! 1 •, Clua L bkL[B- i-ai:L__ciC jji lye;caiiJ_u-f_pi.i^-es \) 

jPtLCw, jicpv ■ liifrull m Uu ymi wanl Lo see Lhrr prioe jqow (Y/S 1 ! ? 
If pr■ "¥■ z 

print || qet_pri^:e[ ) J 
■ 1 * 2 

pricn m 

wh ! 1 m pr Jnit 4 f 

tlM ■ alesp^ @0。 I _ 

\j l Jk^io ■■ yif L pilutrO 

p£l»H B EuyJ-) 


■ h 严 jftsin ， r w u s - h i z/pr 1 ?i ^ htn I 



丁 he Code has 
amended -to ihdlude 

■theW 

ioh. 


on Sli^lN 


K 7 ou hCcdM^c 一 

r\<^i ^ -tW»s y 呼 am 

>/as 七 cs ⑽七 ， W … 

\*b *to Vou. No"tc : 七七 s 

扣 uppeRCA^e Y- 





Flip rrlit r.hHI r^Fhuff nphnn^ Winrinw^ 
rython 3.1 (r31^73572 1 Jul 0 2^09, OSsDOsDB) 

JS5CC 4.3 . J ] uxi lijiuaJ 
Type "copyright" P "credita" or "license [ ]" tor nrarc intormat: 

■>>■> ================ — i.u. ====g=c==='= RESTJIK.T — 1」… -i 一.… n —，~—. 

»> 

UNi you uirinl. t.u L.Titf |ki i Eknv |j Y ? Y 

bulb 

============================ HFISTftKT 

»> 

l> 4 ii yrm uirinl. t.ii mi-; hr I lir yr i [: e ■: elcivj ^ Y /V | 7 N 
IJuy 
■m 




(W^ 

Design principle: reuse code with functions. 

v^F 
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91 





























going mobile 



This is great; it does just what 
I want! In fact, ifs so good ifs given 
me an idea. Since rm on the road a 
lot, rd like the price sent to my cell. 
Can your program tweet me? 


The CEO wants the price sent to his 
cell phone. 

Rather than have the emergency report displayed 
on a PC, the Starbuzz GEO would prefer to get 
something more immediate while he’s on the 
road. He needs messages to be sent directly to his 
Twitter account. 



Sending a message to a Twitter account feels like a tall order. 
Where do you think you’d start looking for helpful suggestions and, 
quite possibly, a solution to this new problem? 
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functions 


Use the 



Luke 


It’s pretty complicated to write a program that sends messages to a service 
like Twitter. Fortunately, other people have already tackled problems like this 
and posted their code on the Web. Here’s a Python function (found on the 
Web) that is very similar to what you need: 

TWis i\\c 

message 栋 at 』 ^ scv '七 • 





Put 70 ^' 


def send—to_twitter(): 

msg = n I am a message that will be sent to Twitter" 
password—manager = urllib.request.HTTPPasswordMgr() 
password manager.add password("Twitter API", 

” http://twitter.com/statuses”，”•••，，，”• 
http handler = urllib.request.HTTPBasicAuthHandler(password manager) 
pa g e ： opene r = Urlllb • request • build —opener (http—hanger) — 
urllib.request.install opener (page opener) 
params = u.IMb.parse .^encode ( Status ▼: msg } ) 

resp = urllib.request.urlopen("http :// twitter.com/statuses/update.j son 
resp.read() 


Put youv- 

p^sswoird 


params) 


This code looks complex but, for now, all you need to know is that it sends 
a message to the Twitter service. An advantage of using functions (which is 
illustrated here) is that they allow you to understand a program at a high level 
without having to initially understand all the details. This is known as working 
at a higher level of abstraction. 





This code looks like it could be useful. But is 
there a problem? 

Why can’t you just replace the print () 
calls in our existing program with calls to this 
function? 



this! 


To use the code you will first need 
to sign up for a free Twitter account. 
To register, go to: 

https :// twitter.com/signup 


you are here ► 
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the message stays the same 


The fuwctiow always sends the 
same message 


Reflate 
tails -bo 
w p\rm 七 ()”. 


price_now = input ("Do you want to see the price now (Y/N) ? ’，） 
if price_now == M Y M : 

print(got_prioQ() ) —- send—to—twitter() 

else : ^ ^djjo 


price = 99.99 
while price > 4.74: 
time.sleep(900) 
price = get_price() 

piiiiL ("Buy! send to twitter () 


-Puh^iioh ihs-tcad. 



IWilturl tHoim* 


b 坩 idil Jmh McIej 


The S-tdvbuzi 

O^B-0 s 

o" Twi-fc-tcv-. 


What are you doing? 




MCOCidl 


「 h¥i 


m#-LiJ^ii IKaI wd\ b 


hn 


Home 


liS 


sf ^rbuzzccD I .1 iTiEnLtjL ： 

TwIttCF 







st^rb'yuciiQH 1 dm d Tnc^a^gi: that wlU be m ^zn\ Ec 
twkter 


stdrbkuztd levels htc ri pumina lg rwrmdl now 

Ihal th« Head nrpl Prcgrammml Writing Retreat 
W^kirriEf ih qvl'i M.in. E|1pMf c^n ilrinlc c<arf-L a in IR 


Fjhmr 


Ko 你 aUw — W ^。 奶 W 如 


\\C\\ oft»oy\ 1 

作 0 ” fuW 


Wt.ov> se,ds -tv,c sa^c Wc-t 

TWi 七七吖， 


♦ ♦ * Cf €> 龜 1 


httpiVflWlttCTCIMTJ \ 

V 


- - 


ItaiUcr / Mekhic 

\ 

\ 

ri* 
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functions 


Well, duh y \Ys pretty obvious really... 
you need a version of the function 
that tweets the low price and 
another that tweets an emergency 
order. How hard is that? 


O 




def send—to_twitter_price 一 low(): 

# original code here... 

# ••.but change message to 

# buy at low price. 


def send_to_twitter_emergency() : 

# original code here... 

# ... but change message to 

# place an emergency order. 




Something doesn’t feel quite right about this solution. 

Can you see the problem that this creates? Can you 
think of a solution that fixes the problem? 


as m 

avc todc a 

todcr aryd avc -to be read bv 

coders Code 

Pytw \^0\rcs all towwc^ts, bcdausc 

七 ㈣ avc 灼’七 code 
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set parameters 


Use parameters to avoid duplicating 
fuwetiows 

Just like it’s a bad idea to use copy’n’paste for repeated usages of code, it’s 
also a bad idea to create multiple copies of a function with only minor 
differences between them. Look again at the proposed send_to_ 
twitter_price_low() and send_to_twitter_emergency() 
functions on the previous page; the only difference between them is the 
message they send. 

A parameter is a value that you send into your function. Think of it as 
the opposite of what you get when you return a value from a function: 


Call 

and sevui 弓弓 I as a 



Rctu\rh 6ov\ixo\ ijo the 

^llihj 乙 ode. 



CohhCdt -to Twi-fc-tcv 3hd 
schd the message with -the 

-to -the CtO. 


The parameter’s value works just like a variable within the function, except 
for the fact that its initial value is set outside the function code: 



七 1 T v ^ sioh 仏纤伽, 

ms 9 vaviablc is sei "to 

^ c w valuc ?asscd ih b y ^ ^11 

■to 



def send_to_twitter(msg) : 

password manager = urllib.request.HTTPPasswordMgr() 
password—manager•add—password("Twitter API' 

"http : // twitter . com/st( 
http handler = urllib.request.HTTPBasicAuthHandler(pas 
pagelopener = ur lllb • request • bu lld —opener (http—hanc^ 
urllib.request.install opener(page opener) 
params = urllib . parse .^encode ( Status ，： msg} 
resp = urllib•request•urlopen( n http://twitter•com/ 



















functions 


Parameters Up Cl^se 



To use a parameter in Python, simply put a variable name between the 
parentheses that come after the definition of the function name and before the colon. 
Then within the function itself, simply use the variable like you would any other: 




like ahy o-thcv- 

vaHablc. 


return ("Congratulations " + the name 


Later, invoke the function from your code with a different parameter value each 
time you use the function: 

print(shout_out('Wanda *)) 

msg = shout_out('Graham, John, Michael, Eric, and Terry by 2') 
print(shout_out('Monty')) 


腎 ^ flr oen your pencil 



Grab your pencil and update your program. Do the following: 


1 • Modify the send—to—twitter () function so that the message text is 
passed into the function as a parameter. 

2. Update your code to make the approriate parameterized calls to 

sent to twitter(). 


you are here ► 
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ready to tweet 

r ^Sharpen your pencil 

Solution 


You were to grab your pencil and update your code to 
incorporate a version of send_to_twitter () that supports 
parameters: 


import urllib.request 
import time 


The 


dc-f *to_ 


，娜 “he 


def send t q twittc i~ (): 



password—manager = urllib.request.HTTPPasswordMgr() 
password_manager.add—password("Twitter API n , 


"http : / / twitter. com/ statuses " r 
http_handler = urllib.request.HTTPBasicAuthHandler(password 一 manager) 
page_opener = urllib•request•build—opener(http 一 handler) 
urllib.request.install 一 opener(page_opener) 
params = urllib.parse.urlencode( {* status * : msg}) 

resp = urllib.request.urlopen("http :// twitter.com/statuses/update.j son ", params) 
resp.read() 


def get_price() : 

page = urllib.request.urlopen("http :// www.beans-r-us.biz/prices.html") 

text = page.read().decode("utf8") 

where = text.find('>$') 

start_of—price = where + 2 

end_of—price = start_of—price + 4 

return float(text[start_of—price:end—of—price]) 

price_now = input("Do you want to see the price now (Y/N)?") 


if price_now == M Y" : 


else 


price = 99.99 
while price > 4.74: 
time.sleep(900) 
price = get price() 
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TesT DriVq 


Now you’ve amended the program code, it’s time to see if it works. Make 
sure the amended code is in IDLE, and then press F5 to run your program. 

To begin, let’s send an emergency message: 



Python shell 


Eile Ldit Shell Uebug Options Windows 

Python i.l \Tlli Ju 丄 H DU ： :Uid:UU] 

{GC.C. 4 . 1 * 1 ] on limiic? 

Type ■copyriqtit" r "credit b n or " license [)" tor Ewsre intormation 
>» — - — -- —— -- RESTART 

Do you wont to set the price now (Y/K)- f Y 
> >> 




V® u asked *Po\r ah 

pv-i^ c 

Ad heve i-t is. 




That worked. But what about the price-watch option...? 
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message received 




Tesr DriVq 


canTintQD 


••• 



£ilp £riif FihpN r>phiig ： flplmn 11 ； 迟 inrinws 

i'ytfton i.l (rdl: rd^fZ, Jii 丄 H iUOy, DSsUH:OB] 

[fisTir 4 - 1 A 3 I i¥n I i mix? 

lype -copyrigtit r, P "eradita r, or " liceriHe [ ) n tor more intormatiQn 
>» ===================== : ======== HKSTMIT 

»> 

Htti yrm Twimt tn ■■we f.hr^ pr i rzf ： rtow j[ V/Tf) ? W 
»> 


You decide bo a^d 
(eventually) We 七 

y/*i*tV) a message -to — 

Hornes *(Jvru 
priC-c is \ri^*t)- 



That works as well. You’re ready to go live! 


Bcc?, bcc ? …叫 as •bha 七 
sowCoy\C s ^V>oy\C? v. 


Great, an emergency order! 
ril quickly place a call 
before we run out of beans 
again... 



" 0 wheire the 

^ S-bvbuzi CBO is, he 
hs his 々 II hcavby, he 
gets -the 

message. 
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functions 


thereicire no ^ 

Dumb Questi9ns 


Can I still call the Twitter function like this: send_to_ 
twitter()? Or do I always have to provide a value for the msg 
parameter? 

As it's written, the parameter is required by the function. If 
you leave it out, Python will complain and refuse to run your code 
further. 

Can parameters to functions be optional? 

Yes. In most programming languages (including Python), you 
can provide a default value for a parameter, which is then used if 
the calling code doesn’t provide any value. This has the effect of 
making the parameter optional, in that it either takes its value from 
the one provided by the caller, or uses the default value if the caller 
does not provide anything. 

Can there be more than one parameter? 

Yes, you can have as many as you like. Just bear in mind that 
a function with a gazillion parameters can be hard to understand, 
let alone use. 

Can all the parameters be optional? 

Yes. As an example, Python’s built-in print () function 
can have up to three optional parameters, in addition to the stuff to 
print (which is also optional). To learn more, open up a Python Shell 
prompt and type help (print) at the »> prompt. 


Doesn’t all that optional stuff get kinda confusing? 

Sometimes. As you create and use functions, you’ll get a 
feel for when to make parameters mandatory and when to make 
them optional. If you look at the description of print () again , 
you'll see that in most usage scenarios print () takes a single 
parameter: the thing to display. It is only when extra, less common, 
functionality is required that the other parameters are needed. 

The description of print() mentions “keyword 
arguments.” What are they? 

The word “argument” is another name for “parameter,” and 
it means the same thing. In Python, an argument can have 
an optional “keyword” associated with it. This means that the 
parameter has been given a name that the calling code can use to 
identify which value in its code is associated with which parameter 
in the function. 

Continuing to use print () as an example, the sep, end, 
and file parameters (a.k.a. keyword arguments) each have 
a default value, so they are all optional. However, if you need to 
use only one of them in the calling code, you need some way to 
identify which one you are using, and that's where the keyword 
arguments come in. There are examples of these optional features 
of print () and other such functions later in the book. Don’t 
sweat the details right now, though. 


you are here ► 
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password changes 


Someone decided to mess with your code 



About time I changed the Twitter 
password. Hmmm... Interesting code, 
but it would be great if it printed a 
message every time it sent a tweet. I 
think Til just improve it a little... 


One of the Starbuzz coders decided that the password 
should be set at the start of the program, where it can be 
easily amended in the future. This is what she added: 


STARRVir/ 


CORY 


HE 

UliT TOTALLY WlREti 


import urllib.request 
import time 

def set_password() : 

password= M C8H10N4O2 M is i\\t fasswovd. 

TV CodtY wants -to sci ihe 
set—password() P^sswovd ai -the ioy o( -the 

•file wheire i-t s easy -Pihd. 

def send_to_twitter(msg) : 

password manager = urllib.request.HTTPPasswordMgr() 
password__manager. add_password ( "Twitter API 

'http :// twitter.com/statuses", "starbuzzeeo' 



So, later in the program, the code uses the password 
variable. That means that next time the password needs 
to be changed, it will be easier to find it in the code 
because it is set right near the top of the file. 
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i'ytnon 
{GC.r. 4. 


Type ■copyright" P "credita 


»> 



y jyoy, owsuhsu-b) 

or " Iiccnoc [) " lor evore 1r.tor7nat3.on. 
=====：== ■: HEPITMIT ================ 




Oh no! It crashes! What happened?!? Our order 
system has stopped working worldwide! If we don’t 
get information on where we need coffee orders soon, 
this could be the end of Starbuzz... Help! 


The program has crashed and it can no longer send out 
messages to the GEO. Stores across the globe are running 
short on beans and it’s up to you to fix the code. 






Look at the error message that was generated when the program crashed. 
What do you think happened? 





Tesr DriVq 


Add the new password code to the top of the program and then 
run it through IDLE: 



u 


'ad ? 

7 X 

aLE 

drL 


rdEprl 


I 3 
.■.fa 
i 1 
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add it to the stack 


The rest of the program caw't sgg 
the password variable 

The program crashed because, for some reason, the program 
couldn’t find a variable called password. But that’s a little odd, 
because you define it in the set_password () function: 


def set_password() : 

password= M C8H10N4O2 


，， ^— TW»s todt sc-U ^a ss> 




set—pass 離 d () p Thls _^ ‘忪 password to b, s,i 

def send_to_twitter(msg) : 

password manager = urllib.request.HTTPPasswordMgr() 
password manager.add password("Twitter API", 


'http :// twitter.com/statuses 


starbuzzeeo' 


This CoAt uses -the 
passy/ovd". bu 七 -fov- 
some veasoy^, *i*t 七 
see *l*t 

.password) 


So what happened? Why can’t the send_to—twitter () 
function see the password variable that was created in the 
set password () function? 



Programming languages record variables using a section of 
memory called the stack. It works like a notepad. For example, 
when the user is asked if she wants to send a price 
immediately, her answer is recorded against the 
price now variable: 
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functions 


Whew you call a function the computer 
creates a fresh list of variables 



Kevf siack 


tables used 
by -fuh^-tioh 


This new sheet of paper on the stack is 
called a new stack frame. Stack frames 
record all of the new variables that are 
created within a function. These are known 

as local variables. 

The variables that were created before the 
function was called are still there if the function 


T\\t tallmj todts 
vav-iablcs av-c still 


But when you call a function, Python starts to record any 
new variables created in the function’s code on a new sheet 


of paper on the stack: 


def set_j>assword () : 


password:"C8H10N4O2 


needs them; they are on the previous stack frame. 


But why does the computer record variables like this? 


Your program creates a new stack frame each time it calls a function, 
allowing the function to have its own separate set of variables. If 
the function creates a new variable for some internal calculation, it 
does so on its own stack frame without affecting the already existing 
variables in the rest of the program. 


Wken a variable’s 
value can te seen ty 
some code, it is said 


This mechanism helps keep things organized, but 
it has a side-effect that is causing problems... 


to te ” in scope •” 
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local garbage removal 


Whew you leave a fuwctiow, its 
variables get thrown away 

Each time you call a function, Python creates a new stack frame to 
record new variables. But what happens when the function ends? 



The computer throws away the 
function’s stack frame! 




Wlien a variable’s 

value CANNOT te 

seen ty some code, 
it is said to te "out 
of scope •” 


Remember: the stack frame is there to 


record local variables that belong to the 
function. They are not designed to be used elsewhere 
in the program, because they are local to the function. The whole reason 
for using a stack of variables is to allow a function to create local 
variables that are invisible to the rest of the program. 


And that’s what’s happened with the password variable. The first 
time Python saw it was when it was created in the set_password () 
function. That meant the password variable was created on the 
set_password () function’s stack frame. When the function ended, 
the stack frame was thrown away and Python completely forgot about 
the password variable. When your code then tries later to use the 
password variable to access Twitter, you’re outta luck, because it can’t 
be found anymore... 
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^Sharpen your pencil 


This is the start of the program. Write a modified version of this 
code that will allow the send_to_twitter () function to see 
the password variable. 

Hint: you might not need to use a function. 



u r\tt& to v-c>/\r»*tc 



import urllib.request 
import time 

def set_j>assword () : 

password="C8Hl0N4O2 

set_j>as sword () 


def send—to_twitter(msg) : 

password manager = urllib.request.HTTPPasswordMgr() 
pass 離 d = manager . add —passed (fitter 皿 

"http : // twitter . com/statuses M " starbuzzceo" , password) 
http handler = urllib.request.HTTPBasicAuthHandler(password manager) 
pa g e：opener = ur lllb • req 刪 t • build _Q Pener (http—harder ) — 
urllib.request.install opener(page opener) 
params = urll.b. parse "rlencode ( Status ，： msg}) 

resp = urllib.request.urlopen("http :// twitter.com/statuses/update.j son ", params) 
resp.read() 


Witc youv- hew 
vcirsioh hcv-c- 
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create the password variable 


^happen your pencil 

Solution 


This is the start of the program. You were to write a modified 
version of this code that will allow the send_to_twitter () 
function to see the password variable. 

Hint: you might not need to use a function. 


>u needed *to 



import urllib.request 
import time 

def set_j>assword () : 

password="C8Hl0N4O2 

set_j>as sword () 


def send_to_twitter(msg) : 

password manager = urllib.request.HTTPPasswordMgr() 
password—manager.add—password「Twitter API 

"http :// twitter.com/statuses ", "starbuzzeeo ", password) 
http handler = urllib.request.HTTPBasicAuthHandler(password manager) 
pa g e ： opene r = urllib • request • build —opener (http—hanger) — 
urllib.request.install opener (page opener) 
params = urll.b.parse .^encode ( f status ，： ms g} ) 

resp = urllib . request. urlopen ( "http : / / twitter . com/statuses/update . j son" params) 
resp.read() 


This is all you heed -to do ： ius-t 
the vaHable. 

V 

passy/ov-d—'^CSttl ON 午 6)2*’’ 


Bemuse V〆 肅 f S 

匕 UtW should ^ be able see .t. 
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functions 



ovdcv- ^r\U ^c*b tWrou# 


It works! Because you are creating the password outside 
of a function, it is available globally throughout the Python 
program file. The password variable will be recorded against 
the initial stack frame, so the send_to_twitter () function 
will now be able to see it. 

Let’s see how the updated code is affecting 
the rest of Starbuzz. 



Tesr DriVq 


The fixed version of the code has been loaded onto machines 
in every Starbuzz store worldwide. It’s time to try out the code 
and see if you can get the ordering system working again: 



1 

^-i 

tg p>9 > 

y y > > 0 V- 

pM'rA-fc. D ^i 
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full of beans 


Starbuzz is fully stocked! 





H\i\\ -b^c toWcc locals ^ully 
stored, 七 V^c’s pIc^Y ok 

move _o 山赴七 Wmy m 1 如 … 


… ahd theve av-c a lot 
°*f happy Siavbuzi 

^us-tomev-s, -too. 


From Cambridge to Cambodia, from Seattle to Sierra 
Leone, the orders are being placed and the beans are 
being delivered. 

You did a great job. Your system tracks live prices from 
the Web and automatically sends messages to the CEO 
wherever he is on Earth. You are really using the power 
of functions to keep your code clean, concise ， and 
clear. By correctly using variable scope, you even made 
it easy to keep the password up-to-date. 


Well done! 
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Chapter 3 


Phew! You really saved 
the day! And the company! 
For a while there, I thought 
we were sunk... but you got 
us back up and running. 





functions 



Your Programming Toolbox 

You’ve got Chapter 3 under your 
belt. Let’s look back at what 
you’ve learned in this chapter: 


一 v ^ 丁 。0 、 S 


, Vtat 、 w 一 O" 5 ., 

…::: 一 ' ， 卽 … 

a WS . A 

氺 Go 叶如 ^ , 

_ WCS . c “ a 心 # 、 S 

* wb '二 t 二 L ^ t 

a " Py-tKoh Tods 

* A MdV'aWc' s sa ' 6 oAc* * Wsc ^c-f ；； -to £.\rcaic WtiohS. 

yjM ^ stt * 如 ^rctu^rhO io schd a value 



* Wsc u dc-f ;, -to ^caic -Puhdtiohs. 

* Usc ^tu^rhO io schd a value 

"to the dode that died the 

TUh^xioh. 

* ^ ass P 5 ^^ctcv-s -to -fuhd-tiohs by 
pla^.h3 -them betweeh pavchthcscs. 
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CHAPTER 



4 data in ¥!les and arrays 


f Sort it out ♦ 





> 




Ummmm... I just 
hope he knows what 
he's doing... 


As your programs develop, so do your data handling needs. 

And when you have lots of data to work with, using an individual variable for each piece 
of data gets really old, really quickly. So programmers employ some rather awesome 
containers (known as data structures) to help them work with lots of data. More times 
than not, all that data comes from a file stored on a hard disk. So, how can you work with 
data in your files? Turns out it’s a breeze. Flip the page and let’s learn how! 


this is a new chapter 
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waiting for the waves 


Surfs up iw Codeville 

The annual Codeville Surf-A-Thon is more popular than ever 
this year. 

Because there are so many contestants, the organizers asked 
you to write a Python program to process the scores. Eager to 
please, you agreed. 

The trouble is, even though the contest is over and the beach 
is now clear, you can’t hit the waves until the program is 
written. Your program has to work out the highest surfing 
scores. Despite your urge to surf, a promise is a promise, so 
writing the program has to come first. 
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Chapter 4 


娜 Ways 七 . 




data in files and arrays 


Find the highest score in the results file 

After the judges rate the competitors, the scores are stored in a file called 
results . txt. There is one line in the file for each competitor’s score. You 
need to write a program that reads through each of these lines, picks out the 
score, and then works out the highest score in the Surf-A-Thon. 




Results avc sWcd m 


It sounds simple enough, except for one small detail. You’ve written programs 
to read data from the Web, and read data that’s been typed in at the keyboard, 
but you haven’t yet written any code that reads data stored in a file. 
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shredding with the for loop 


Iterate through the file with the op 肌 for, 
close pattern 一 

If you need to read from a file using Python, one way is to use the built-in 
open () command. Open a file called results . txt like this: 

Ue T；t a 


result f = open("results.txt' 




^ of 

the -file {o opch ^ 


The call to open () creates a file handle, which is a shorthand that you’ll 
use to refer to the file you are working with within your code. 

Because you’ll need to read the file one line at a time, Python gives you the for 
loop for just this purpose. Like while loops, the for loop runs repeatedly, 
running the loop code once for each of the items in something. Think of a 
for loop as your very own custom-made data shredder: 


The >lc is 

-fed m*to -fov- loof 


sWddcv-.. 




— 






|Vo*tc ： unlike a v-cal 

shredder, (or loof 

sV^v-cddcv-™ doesn't 
dcsbroy youv* —’七 
jus-t cMo^ m*to 


-- 


The for loop shredder 


TM 




… whidh b\rcaks ii up irrfco or>c- 
li^C—3 — ■tiw'C dhunks (v/hidh 3\rc 
■themselves s-tv-mjs). 


Each time the body of the for loop runs, a variable is set to a string 

containing the current line of text in the file. This is referred to as iterating 

through the data in the file: -rile 3^ 

^ a -f ile V^a^dlc. 

result_f = open("results.txt") 

po i\\t youve just 

i\^t -flic, k cast, you out tV^C 
*fo\r loof’s Codt »s mdcr\*tcd- 


TV^C w ca^Jrnc w variable is 
set *to i\\t Imc ^ow> 

i\^t hie cm taeM 

TV^c -for loop s-bofs 

\ru 灼 oiA*t o^c li^cs "to 


you 
\rcad- 


for each 一 line in result_f : 

print(each 一 line) 
result f.close() 


v-edd -fv-om 

Ime. Notice 



Close ihc -file (ihv-ou^h ihc -Pile handle) 
when youVc done wi-th it 
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data in files and arrays 



Code Magnets 

You need to complete the code to find the highest score in the 
results . txt file. Remember: the for loop creates a string from 
each line in the file. 

Hint: For the program to work, you will need to convert the string 
into a number. 


highest_score = 0 

result—f = open("results.txt") 

for line in result—f: 

if .(.) …… 

result—f•close() 

print ("The highest score was :，'） 

print(highest_score) 
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getting the highest score 



Code Magnets Solution 

You needed to complete the code to find the highest score in the 
results . txt file. Remember: the for loop creates a string from 
each line in the file. 

Hint: For the program to work, you needed to convert the string into 
a number. 


highest_score = 0 
result—f = open("results.txt") 
for line in result f : 
if 



float 



*to 
Code 

"msidc loof ANP 

dadm msidc ___ 

'FstaWnt result_f . close () 


print("The highest score was : ") 
print(highest score) 

T _ „ 

loop \ruv>s, ^csi_sC.o\rc 

va^ablc should V^avc tKc best 卞十 : 

data 仏 so 7 ou wbb ahead ad 

•rb cm stv-ccv>* 



TVic 、吵 est 一 variable 

updated cvev-y time you -f'md a I'mc 七 
d V^'i^cv" s£.o\rc. 


K 


Rcmcmbcir -to dohVc\rt the stv-ihg io 

a with -PloatO. Evch ikou 3 k 

the lihe is a hunr»bc\r, it Hornes irrto 
"the as B stirih^. 




To successfully run this program, you need to grab a copy of the results . txt 
data file from the Head First Programming website. Be sure to put the data file in 
the same directory (or folder) that contains your code. 
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data in files and arrays 



Tesr DriVq 


It’s time to see if the program works. Use IDLE to create a new file using the code 
from the previous page, save your program as high 一 score • py, and then run it by 
pressing the F5 key: 



v\0) s 

south heve … 


>corft. py - /h e maybirryp/Hvad F ErctP r«g/ 


Eile Ldit rarmat: Bun Options Windows 


jiiqhest_acOir& s o 

rcault_t - opcn{ ' rcu uU .twt" ] 

i line :□ rcaylt_f : 

riEIrll ^ 1 > III L Cjlltf H I HSILSrf ?： 

tilqIie3t_acore =： rloanjLine, 
rcau -丄 t_l. cloac (J 

print( p Thc highea t score waa : K \ 

i ri I [ h L LjliK'M ； I fic：H hr t j ； 


Help 


S -the pirojlrarh 

pyped idlb. 


Python shell 


£ile Ldd SheJI Uebug Dptwns Windows 


Python 3,1.1 (rail：744 60 ,, Aaq 18 2009 r 01:03-43 ^ 

[rn ： l.i.Sf on 丄 inuia 

Type "copyright" P *credita" or p liccnac{)" for sore information■ 

>P-> =================== ■RKSTflHT ===================== 

>» 

Trac&DacjK. ^DH>st recent call l^Et ；■ s 

File w /hocac / barryp/EEDadTirat?rog/chapter^ / code/hiqh_3C[>rc , py" , licic 4 P in 
3 f flnnt ^ 1 iTvr ]i > h i ghr nt fic^rrrr : 

VdlutrEx,ciLU; : -uullIU 口 uL truiJvex,L ^-Li._aiL| tu £LlmLe JuGuuiy 8 . 

>» I 


Help 


I n: 1 fl Cn\ J 


Oh dear. It looks like something’s gone wrong! The program has 
crashed with a ValueError, whatever that is. 


Look's like you art 

■to dor\VCV"*t 七 

didn’t look like a number. 





Study the error message produced by Python. Is there something wrong with 
the Python code? Is there a problem with the file? Is there something wrong 
with the data? What do you think happened? 
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names and numbers 


The file contains more thaw numbers... 


To see what happened, let’s take another look at the judge’s score sheet 
to see if you missed anything: 


The oWidial ID 

bdd^e >was dovcvm^ uf 七 he 





丁 3\rc "two pieces 
of ih-pov-rha-tioh oh 
caA \\y\c a har^e a^d 
a hurwbev fthc suv--fcv 
sdo\rc). 


The judges also recorded the name of each surf contestant next to his or 
her score. This is a problem for the program only if the name was added 
to the results . txt file. Let’s take a look: 



And that’s a problem for our code because, as it iterates through the file, 
the string you read is no longer a number. 


^sulis i h the -Pile 

like this. 
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data in files and arrays 


Split each line as you read it 


Each line in the for loop represents a single string containing two 
pieces of information: 


Johnny 

8 

. 65 

Juan 

9 

• 12 

Joseph 

8 

• 45 

Stacey 

7 

• 81 

Aideen 

8 

.05 

Zack 

7 

.21 

Aaron 

8 

• 31 


Wm 


The for loop shredder 


,TM 



Irnc a a^d a 於 ’ 


bcv-, 


as a 



To isolaic ihc sdov-c, you y\ttd bo 
匕 u*t Imc m "tv/o. 


You need to somehow extract the score from the string. In each 
line, there is a name, followed by a space, followed by the score. You 
already know how to extract one string from another; you did it for 
Starbuzz back in Chapter 2. And you could do something similar 
here using the find () method and index manipulation, searching 
for the position of a space (y) character in each line and then 
extracting the substring that follows it. 


Programmers often have to deal with data in strings that contain 
several pieces of data separated by spaces. It’s so common, in fact, 
that Python provides a special string method to perform the cutting 
you need: split (). 


/W youll 払 at 

Similar \o>r Wcak'mJ uf 


Python strings have a built-in split () method. 
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split the string 




Looks like you can use multiple assignment and split () to 
extract the scores from the results. txt file. 


The splitH method cuts the string 


Imagine you have a string containing several words assigned to a variable. Think 
of a variable as if it’s a labeled jar. 


rock_band = M A1 Carl Mike Brian 


A si^U variable is ass—... 


•a single wliidli 

*Pou\r y/o\rds. 


vav'isWc) 3 
labeled jav. 


The rock—band string, like all Python strings, has a split () method that 
returns a collection of substrings: one for each word in the original string. 

Using a programming feature called multiple assignment, you can take 
the result from the cut performed by split () and assign it to a collection of 
variables: 


T\\c Ic-f-t side 

ass'»^mcr\*t o\>C\ra*to^r lists ^ 
七 he variables -to ass'i^ 
values -to* 


A s*tiri h g ; 

^°^i3iy\cd 
ih ^ v^lridble 
(jam). 


(rhythm, lead, vocals, bass) 




The \riglvt side o( ihc 
assij^rwe^-t opeva-fcov- 
rock—band • split () 七 he ddll {jo 

七 he spli-tO rwcihod. 


… eadli y/i*tli i*ts ov/h 

stirihged value. 


Each of the return values from the split () on rock—band is assigned to its 
own separately named variable, which allows you then to work with each word in 
whatever way you want. Note that the rock—band variable still exists and that it 
still contains the original string of four names. 


vocals 


A1 

Carl 

Mike 

Brian 


Mwl 七， … vav’aWes … 
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data in files and arrays 




Here is the current version of the program: 

highest_score = 0 

result—f = open ( "results.txt") 

for line in result—f: 

if float(line) > highest_score : 
highest_score = float(line) 
result—f•close() 
print("The highest score was : ") 
print(highest_score) 


Write the extra code required to take advantage of the split () method and multiple 
assignment in order to create variables called name and score. Then use them to complete 
the program to find the highest score. 


you are here ► 
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find the top score 



Here is the current version of the program: 

highest_score = 0 

result—f = open ( "results.txt") 

for line in result_f : 

if float(line) > highest_score : 
highest_score = float(line) 
result—f•close() 
print("The highest score was : ") 
print(highest_score) 


You were to write the extra code required to take advantage of the split () method and 
multiple assignment in order to create variables called name and score, then use them to 
complete the program to find the highest score. 


TV^c cmly Code 

Jfov- loof. T\\t \res*t of 



pv-ojv-am \rcma*ms 


-for I'mc *m result 





sdov-c) =■ lme.splrtO 


i-f -floa*t(sdo\rc) > hijhest 一 sdore: 

^ hi«jhest_stove — -floaiCstove) 

You av-c v\o lo\r^C\r 
tompavmj ImC *to 
七 stov-c, so 
be suv-c *to tom^av-c 
u sdo\rC ；， V3\ri3blc nr\S*tc3d- 
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data in files and arrays 




Tqst DriVQ 


So what happens when you run this version of the code within IDLE ? Let’s 
amend the code and see: 



_£core2.py - /horn a/barryp/Head F ErEtProg i 


£j|p frlit rnrm-Rt Rmri Optirwi^i Windrows 


JiicfheBt_flcore - 0 

roault_f - opcn(' rcjulta .tut" ) 

1 inr rrrunTi t f : 

{nasSj score) = Line-apliif] 

■ ;loa.t(EGore] > fiigtieat 一 flGore: 
hLghcat_acorc ^ floatfacorc! 
r M^iul fc fji 
print [ "The Mqneet acore vae s ■ |i 
print [tiigiicot [leoifcli 



a ^«hdcd tod^ whi^K 



TWis time, ^royra 
^roduts a v-csul*t you 
cav\ actually vasc. 


It works! The program reads each line from the file as a string, extracts the 
score using the split () method, and then uses it to find the highest score 
in the file. The organizers are so excited to hear that the program is finished 
that they immediately display the result on the large scoreboard at the back 
of the beach. 


TV^c results av-c \ J 


Or av-c ■biie '/ …？ 





















more top scores 


Put you need more thaw owe top score 


As soon as the top score appears, people start to wonder what the 
second and third highest scores are: 


You av-C miss’” some 
sdorcs … ■bV'C 2- 
ay\d stores av"c a 
mys-tev-y. 



It seems that the organizers didn’t tell you everything you 
needed to know. The contest doesn’t just award a prize for the 
winner, but also honors those surfers in second and third place. 


Our program currently iterates through each of the lines in the 
results . txt file and works out the highest score. But what it 
actually needs to do is keep track of the top three scores, perhaps 


Looks like you Y\ttd c%*bv-a 

vav-'idblcs -for a 灼 d 

■tWirdl stov-cs. 



in three separate variables: 
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data in files and arrays 


Keeping track of 3 scores makes the code 
more complex 户 

So how will you keep track of the extra scores? You could do something 
like this: 


This is HOT veal 

Pythoh todc. It s what -— ^ 

^11 M p SC udo- 

fW They use i-t wheh 
they dve skc-tdhihg out 
ideas av\d wovk'mg oui a 
^oyra^s logid. 


set the highest_score to 0 
set the second—highest to 0 
set the third highest to 0 
derate through each of the scores: 
if the score > highest_score : 

set the third—highest to second—highest 
set the second—highest to highest_score 
set the highest_score to score 
otherwise if the score > second—highest: 

set the third—highest to second—highest 
set the second—highest to score 
otherwise if the score > third—highest: 
set the third highest to score 


You can see that there’s a lot more logic here, because the program needs 
to “think” a bit more. Unfortunately, turning this logic into code will 
make the program longer and harder to change in the future. And, let’s be 
honest, it’s somewhat more difficult to understand what’s actually going 
on with the logic as shown here. 


How could you make this simpler? 

|harpen your pencil_ 


Think about what would make the program easier to write. Check 
the box that you think would have the greatest impact: 


If there were no names in the file, only numbers 


If the scores came before the names in the file 


If the data were ordered highest to lowest 


If you knew exactly how many lines are in the file 
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sort the data 


^Sbarp your pencil 

Solution 


You were think about what would make the program easier to 
write and check the box that you think would have the greatest 
impact: 


If there were no names in the file, only numbers I the data were ordered highest to lowest 


If the scores came before the names in the file 


If you knew exactly how many lines are in the file 


Ah ordered list makes code much simpler 


If you had some way of reading the data from the file and then producing an ordered copy 
of the data, the program would be a lot simpler to write. Ordering data within a program 
is known as “sorting:” 


TV^c ^sorted data 




o\rdc\rc\rd fov- 
so\rtcd) 匕 opy o*f 
the sar^c daia 


9 

8 

12 ^ 
65 ^ 

8 

45 ^ 

8 

31 

8 

05 

7 • 

81 

7 • 

21 


TV^C *tof SdoV"CS 3\rC 

-f'lV-s-t -tWcc values m t\\t 
sorted *to 

variables. Easy! 



But how do you order, or sort, your data? What happens to the original data 
in the file? Does it remain unsorted or is it sorted, too? Gan the data even be 
sorted on disk and, if so, does this make things easier, faster, or slower? 

Sorting sounds tricky... is there a “best” way? 
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data in files and arrays 


Sorting is easier m memory 

If you are writing a program that is going to deal with a lot of data, you 
need to decide where you need to keep that data while the program works 
with it. Most of the time, you will have two choices: 



Keep the data in files on the disk. 

If you have a very large amount of data, the obvious place to put it is on 
disk. Computers can store far more data on disk than they can in memory. 
Disk storage is persistent: if you yank the power cord, the computer 
doesn’t forget the information written on the disk. But there is one real 
problem with manipulating data on disk: it can be very slow. 



Keep the data in memory. 

Data is much quicker to access and change if it’s stored in the computer’s 
memory. But, it’s not persistent: data in memory disappears when your 
program exits, or when the computer is switched off (unless you remember 
to save it to a file, in which case it becomes persistent). 




Keep the data w memory 


If you want to sort a lot of data, you will need to shuffle data around 
quite a lot. This is much faster in memory than on disk. 

Of course, before you sort the data, you need to read it into memory, 
perhaps into a large number of individual variables: 


You have lots o-p lihes of 

so youll heed lots 
va\riablcs... 


如 vxccd -to wove 

七 k Vmcs data 

•m the 

-f ile 'm*to wcwov'y 
bc-fovc b> 
sov 七，七 . 




You are going to have a problem if you attempt to move all those 
lines of data into the computers memory. What type of problem do 
you think you’ll have? 


po vou a 
a lot o-f 
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too many variables 


You caw't use a separate variable 
for each line of data 


Programming languages use variables to give you access to data in 
memory. So if you are going to store the data from the results . txt 
file in memory, it makes sense that you’ll need to use lots of variables to 
access all the data, right? 

But how many variables do you need? 

Imagine the file just had three scores in it. You could write a program 
that read each of the lines from the file and stored them in variables 


called first score, second score, and third score: 


TV^c data m 



Imc ih the -Pile gets a 

variable i-fcs ov/h. 


But what if there were four scores in the file? Or five? Even worse, what 
if there were 10,000 scores? You’d soon run out of variable names and 
(possibly) memory in your computer, not to mention the wear and tear 
on your fingers. 

Well, the As are done 
and thafs the first volume 
of all the entries from the 
Encyclopedia Galactica stored 
in memory. Time to tackle the 
Bs t then the Cs, Ds, Es …. 


Sometimes, you need to deal with a whole bundle 
of data, all at once. To do that, most languages give 
you the array. 
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data in files and arrays 


An array lets you manage a whole tram of data 



Hcv-c domes 

daia *bram. 


^ 1 

6av holds 
a sm^lc 
di3*b3* 


So far, you’ve used variables to store only a single piece of data. But 
sometimes, you want to refer to a whole bunch of data all at once. For 
that, you need a new type of variable: the array. 


An array is a “collection variable” or data structure. It’s designed to 
group a whole bunch of data items together in one place and give them 
a name. 


Think of an array as a data train. Each car in the train is called an 
array element and can store a single piece of data. If you want 
to store a number in one element and a string in another, you 
can. 


You might think that as you are storing all of that data in an array, 
you still might need variables for each of the items it stores. But this is 
not the case. An array is itself just another variable, and you can give it 
its own variable name: 



Even though an array contains a whole bunch of data items, the array 
itself is a single variable, which just so happens to contain a collection of data. 
Once your data is in an array, you can treat the array just like any other 
variable. 


So how do you use arrays? 
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create and extend an array 


Pythow gives you arrays with jists 

Sometimes, different programming languages have different 
names for roughly the same thing. For example, in Python most 
programmers think array when they are actually using a Python 
list. For our purposes, think of Python lists and arrays as the 
essentially same thing. 

You create an array in Python like this: 

my words = ["Dudes ", "and"] 


Pv*bW^ode\rst/fitallY use ^ yay 十 

Jort ^ U a list o^ly 

data type, a <A or a 

_be\rs. /W tomes a built- 

tailed w arva/ -for just p^fosc. 

However, as lists arc vevy similar a^d ^ovc 
-flexible, v/c frrPer *to use tVicm, so you do^ t 
•bo w>vry about tWis distm^tion \or no>w. 


Pand^i 


6(\Mt *tV^c 

av-v-ay a 


Assijh a lis-t 
values io ii 


This creates a two-item array and gives it the name my_words 
To look at individual items in the array, index the element 
required: 

>>> print(my—words[0]) 
Dudes 

>>> print(my words[1]) 




You can read individual pieces of data from inside the array using an 
index, just like you read individual characters from inside a string. 

As with strings, the index for the first piece of data is 0. The second 
piece has index 1, and so on. 


Arrays can be extended 

But what if you need to add some extra information to an array? 

Like strings, arrays come with a bunch of built-in methods. Use the 
append () method to add an extra element onto the end of the array: 


>>> my—words•append("Bettys n ) 































data in files and arrays 


Sharp your pencil 


Rewrite your program so that each time you read a new score you 
append it to the end of an array called scores. 

Then amend the code to print out the first 3 scores in the list. 


highest_score = 0 

s toAt 3s result_f = open ( "results . txt") 

» 七 duV"V"Cy\*tW 灼 ds. _p 

1 v. for line in result—f: 

(name, score) = line.split() 
if float(score) > highest_score : 
highest_score = float(score) 
result_f.close() 
print("The highest score was : ") 
print(highest_score) 

Hint: To create an empty array of scores use scores =[]. 
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high scores in the array 


^Sbarp your pencil 

Solution 


You were to rewrite the program so that each time you read a 
new score you append it to the end of an array called scores. 

You were then to amend the code to print out the first 3 scores in 
the list. 


Code. 3 s 

it 乙 urv "⑼七 ly stands. 

if float (score) > highest_score : 
highest_score = float(score) 
result_f.close() 
print("The highest score was : ") 
print(highest_score) 


highest_score = 0 

result—f = open ( "results.txt") 

for line in result—f: 

(name, score) = line.split() 


S*ta\rt 

cmfty av-v-ay. 


stores =■ □ 


P ， o,ess Ihe data i, • 二••七 

the -file as … m vesul 七二 f : 


store) =■ l'mc.spli*tO 


-.but, this append Ihc sco^a??cMoai(sco^)) 
stoves to art av-v-ay. .. 

result f.doseO 


七 ( w The top sdoves were〆’) 


-tV^c data sa-fcly 
S'tovcdi 3\r\r3y> 

out *b^c *f iv*s*t ^ 

av-v-ay clcmcn-b. 



七 (sdovesCO]) 


七 (sdo\res[n) 


ov-esCZ3) 
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data in files and arrays 



Tqst DriVQ 


The program should now store all of the information from the file into 
the scores array before displaying just the top three scores. Let’s run 
the program within IDLE and see what happens: 



acoreB ^ [| 

rc3ult_f - open ( 'rcault 
!■: i line result_r 3 

£ nonic , acazc) - line 
scores. append：^ rloat 
rcault_f.clo□e < S 

i nt. f I h ip 

print (scores[U | } 

pr i rtf (.Ticorft| 

print (Bcores 『 2 


on shtill 


File Frtit r.hpn nplsnm , i Winriowi 


TV>c coAt ? vodutcs ^csc 

-tV,e stoveboa^d- 





Crap. The program is printing out the 3 scores all right, but it’s not 
printing out the top 3 scores in order, and there’s confusion about who 
won. 


Which important step did the program forget to perform? 























sort the array 


Sort the array before 
displaying the results 


The array is storing the scores in the order they were read from the file. 
However, you still need to sort them so that the highest scores appear first. 


You could sort the array by comparing each of the elements with each of 
the other elements, and then swap any that are in the wrong order. 


boxes i h ^ av-v-ay arc 
如 Cd “ ^hdor, oYdtY. 




I 3 I 





That looks complicated. Aren*t 
we doing all this to make the 
code simpler and easier to maintain? 
I wonder if the array has any built- 
in methods that might help...? 


Arrays in Python have a whole host of methods that make 
many tasks easier. 

Let’s see which ones might help. 

136 Chapter 4 


By closely -the a\rvay 

bo/.cs, you ddrt so\rt "therw by 
the bo^cs *m biggesi- 
■to-sirwallcsi ovdev. 
















































data in files and arrays 





■f 




These are some of the methods that come built into every array. See 
if you can match up the descriptions with the method names. Draw in 
the missing connecting lines. We’ve done one for you to get you started: 


Method 

count () 
extend() 
index() 
insert () 
pop () 
remove() 
reverse() 
sort () 


WK^ttKe method does 

Sorts the array into a specified order (low to high) 
Removes and returns the last array item 
Adds an item at any index location 
Looks for an item and returns its index value 


Reverses the order of the array 

Tells you how many times a value is in the array 

Adds a list of items to an array 

Removes and returns the first array item 





Can you work out which two methods you need to employ to allow 
you to sort the data in the order that you need? 


you are here ► 
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soft then reverse 



■f 


翟 pav 铲 a 費罾办 雀它， 


參 




These are some of the methods that come built into every array. You 
were to match up the descriptions with the method names: 


Method 



WK^ttKe method does 

Sorts the array into a specified order (low to high) 

Removes and returns the last array item 

Adds an item at any index location 

Looks for an item and returns its index value 

Reverses the order of the array 

Tells you how many times a value is in the array 

Adds a list of items to an array 

Removes and returns the first array item 



这 aj ? 炫爸 n 


You were to work out which two methods you needed to employ to 
allow you to sort the data in the order that you needed. 

The sort () and reverse () methods look the most useful. You 
need to use reverse () after you sort () the data, because the 
default ordering used by sort () is lowest-to-highest, the opposite 
of what you need. 
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data in files and arrays 


Sort the scores from highest to lowest 

You now need to add the two method calls into your code that will sort the 
array. The lines need to go between the code that reads the data into the list 
and before the code that displays the first three elements: 




TV away o 以 "m a … (W 

ovtiev*. I 七 ’ s w uy\sov*tcd- 


3 



result—f = open("results.txt") 
for line in result—f: 

(name, score) = line.split() 
scores.append(float(score)) 

Pu 七七 he c 士 a resuit—f.close() 

Code here- 、 



print("The top s 
print (scores[0]) 
print (scores[1]) 
print(scores[2]) 


scores were : ") 


you are here ► 
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all sorted out 


r^Sbarp your pencil 
虼 Solution 


Here is the existing program. You were to add in the missing code 
that sorts the data, highest-to-lowest. 


[] 


scores = 

result_f = open ( "results.txt M ) 
for line in result—f: 

(name, score) = line.split () 
scores.append(float(score)) 

result_f.close() At this poiht ih the dodc, the a^ay is 

ih but it S hot ih ov-dc/you 

It s uhSo\rtcd- 

sdores.sortO 

These mc*t^od tails Will sov*t 


sdo\rcs.\rcvc\rscO 


*tV>c ddia \v\b> *tV>c v-c<\u*ivcd ovdev-. 


print("The top scores were : ") 
print (scores[0]) 

print (scores [1] ) ^ """" ^ ow "the 3\nray is sov-ted ； "the 

print (scores [2]) 


w w 'enc Ti\rs 

七 hvee elements ^ohtaih the high s^ov-cs. 



A-Ptc\r -the ca\\ -to sov-to av\d 

y'C^CY'ScO, "tKc 3\r\r3y is so\rtcd 
•… the o\rdc\r you heed- 



Bits - 

It was very simple to sort an array of data using just two lines of code. But it turns out you can do even 
better than that if you use an option with the sort () method. Instead of using these two lines: 


scores.sort() 
scores.reverse() 

you could have used just one, which gives the same result: scores . sort (reverse = True) 
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data in files and arrays 



Tesr DriVq 


Update your program in IDLE and run it. Look what happens: 



>Gor«_arrayt_sort0d.py - /honifl/b 


Die Edit rarniat; Bun Qptions Windows 


a cores [ J 

fisj 1 i - f — npftn -J 1 

r.； line .n re 3 ult_ls 

(najM, score) - 1 in^^pl it {) 
scores „append( f 

_'Pt 



The additiohal udt chsuv« -the 
M su| b 把 ih ihe ovdev you heed. 


Python shell 


rcault.. f .clciaD^ ) 


acorc . sort {) 
hu]eh. r e-;wh：[ .II-:^ J 

^ii* i ni ( 11 Tilt* I ip[j -Mmr 
print (scores 11> | J 

r. t i ri h ( nnorc [ 1 | ^ 

print £ scores 丨 2 ■ ji 


Looks loc 七 W 


The program works great! 



£ile Ldrt SheJI iQebug Dptions Windows 

Jjython A . 1.1 (rill: Aug 1 « 

[RCfl 4 . -I ^ 1 ] mm 1 1 mix? 

Type ■ Gop'YriqJit *■ j " cr€ dit a - or "Iicanse^ )■ lor mors information 
»> 一 ——- — -- ——- --- — --- ———墨一 RESTART 

The top scorea were: 

9 , 12 
B .65 
B .^5 
»> 


The scores are in descending order, and the program is really not much longer 
than when it found just one score. Using arrays allows us to solve a much 
harder problem with very little extra code. And instead of using lots of 
complex logic and lots of variables, you have straightforward logic and only 
one variable: the scores array. 























scores without names 


And the winner is...? 

It’s time for the award ceremony. 

The prizes are lined up and the scores are on the scoreboard. 
There’s just one problem. 

Nobody knows which surfer got which score. 



Winners 


You 仏 c 

stow, W 七七 
suv^-fevs ⑺ a w'Y s ^ c ' r '/** 
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data in files and arrays 


You somehow forgot the surfer names 

With your rush to catch some waves before the light is gone, you forgot 
about the other piece of data stored in the results . txt file: the 
name of each surfer. 

Without the names, you can’t possibly know which score goes with which 
name, so the scoreboard is only half-complete. 

The trouble is, your array stores one data item in each element, not 
two. Looks like you still have your work cut out for you. There’ll be no 
catching waves until this issue is resolved. 



How do you tkink you 
can remember tke names 
and tke scores for eack 
surfer in tke contest? 


Once you’ve tkougkt 
al>out tkis problem，turn 
over to Ckapter 5 anct 
see if you can resolve 
tkis issue. 



you are here ► 
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programming toolbox 



Your Programming Toolbox 

You’ve got Chapter 4 under your belt. 
Let’s look back at what you’ve learned 
in this chapter: 


… 丁 00 ' S 




* 加 

氺 

\c 


一 ㈣ < 


二二 “ tes 


a 


toWt^ 


ma — 紕 


orAtr 



Py*tKoh Tools 

* 啊 0 -啊以 饮 p^ C ssi h9 
决 ^loscO — ^losc 3 -file 

* 4\r - i 七 ⑽ te ova somc-thihj 

^ 叫 S _ “如 3 ‘ multiple 

* n — ihe attay i»de^ opev-aW 

* a ^y ^dO - add a, ^ -to ih e e ,d 
av-v-ay 

higheir SO，r ^ 0 ~ S °^ 3h lowe 吐 - 

* ⑽ 《 〆 ） - 如咿 the 饮如 J ah 
by \rcvcvsihg i-t 


mds 
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5 Kasiies and dcttabases 





f Putting data 


參 


♦ in its place 


To surf ones data properly, 
one must constantly practice 
ones pose... 


Arrays aren’t the only show in town when it comes to data. 

Programming languages come with other data-arranging goodies too, and our chosen tool, 
Python, is no exception. In this chapter, you’ll associate values with names using a data 
structure commonly called the hash (better known as dictionary to Python-folk). And when 
it comes to working with stored data, you’ll read data from an external database system 
as well as from regular text-based files. All the world’s awash with data, so turn the page 
and start applying your ever-expanding programming skills to some cool data-processing 
tasks. 


this is a new chapter 





















still looking fora winner 


Who wow the surfing contest? 


In the previous chapter, you worked out the top three scores, 
but they’re not much use without the names of the surfers that 
achieved those scores. There will no be surfing for you until 
you’ve finished the program. 



Winners 


Here’s the code so far: 


scores 

result_f = open("results.txt") 
for line in result f : 

(name, score) = line.split() 
scores.append(float(score)) 
result_f.close() 
scores.sort() 
scores.reverse() 
print ("The top scores were :’，） 
print(scores[0]) 
print(scores[1]) 
print(scores[2]) 


You still don 七 

>wov>. 
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hashes and databases 


^Sharpen your pencil 



Rewrite your current program to use two arrays: one to keep 
track of the scores, the other to keep track of the surfer names. 


you are here ► 
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two arrays 


Sharpen your pencil 
k Solution 




You were to rewrite your current program to use two arrays: one 
to keep track of the scores, the other to keep track of the surfer 
names. 


^ic\\ as stores scores =■ □ 

av-v-ay) 7° u 灼。…灼 

a 咖 cs a 代 ay W ^ —es 二 □ 

resul*t_jf 二 opcr\(Vcsul*b.*t%*t w ) 
-for l*mc *m : 

sdore ) 二 lme.splrtO 

AfpChd -the su\r-Pc\rs AfC\ u w 

"bo "the sv'Vdy. sdov*cs.3ppcK\oCTio3*b^sdo\rc// 

resul*t_*f.doseO 
sdo\res.so\rtO 


sdo\rcs.\rcvcrscO 


Rcwcwbcv -to sov 七七匕 

y\3mCS 3 ^ 3 ^* 


har«CS.so\rtO 


har«es.\rcverscO 


pr'm*t( u Thc hi 咖 s 七 stores y/ere〆 ’） 

p\r'm*t(hamCsC03 + 1 y/i*th 1 + s*t\r(sdo\rcsC03)) 
p\r'm*t(hair«CsCI3 + 1 y/i*th 1 + s^\r(sCo\res[IJ)) 
f\rir)i(r)^csCZJ + ' with ’ + s*br(sdo\res[Z])) 



Don't forget to download results . 
txt from the Head First Programming 
website before continuing. 
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hashes and databases 



Tesr DriVq 


With the results . txt file saved to the same directory as your program, enter this 
code into IDLE and see what happens. Remember to save your program, then press 
F5 to run it. 



arrays, py - /h&m a/b arryp/H oadf \nt P r&g/cha pt 


Hip Fflrt fnrmafr Ritn Ofihnn^ 




■BG.DreB ~ 1J 

nrt [ 

rsBUIt_I - op-en, I " rea-'j ItE . tKt' 

1 i nrt rmnlh f z 


[name 


score 


line.split{ 


^corca i append ( flo-at j score )} 
n aine-s. a.ppe nc3 [ name ) 
rc 3 ult_f iClo^c ij) 

3 corci 3 . aort( ji 
ac-urts a - ( |< 


]】tunbfif . aw L f t 

noinca. rcvcrac (J 

print [ " Til e IhigrieBt 300 

^KJ i 111 ( 【 •rt!T：d I ] 卞 4 W 

print [ n^r.€ b [ I f + 
r： t i rit ( nn ： rr:«n[? ] I 


These results doh't make schsc/ 


Python sh#ll 


leTI 


£ile Ldrt &hejl Uebug Options Windows 


JJelp 


python J . 1. I ( rJll s r Auq 1M J 

^ Lt * {GCC H3J cm iin\ix2 

Type ~copyriqht" T "ciadlts" or " license [) 11 Eoio^ore information 
>» -- - -- - -- —- -- RUSTAM 


The highest score□ were 
Z^L-t w 丄 U] ^„I2 
Ktaccy with m 
iTurtaa v i L.li fl . 4 !1 

»> I 


； Ln: Ifl fill: d 


Those results look a little strange. Zack is only a novice surfer but, according 
to the results from your program, Zack has the highest score. It looks like the 
association between the surfer names and their scores is somehow lost... and if 
you think about it, this is exactly what’s happening. 


The two arrays are independent of each other: one contains scores, the other 
names. When the data is in the file, the surfer name and the scores are associated 
with each other because they appear on the same line. However, once the split 
occurs and the data is in the arrays, the association is severed. Sorting one array 
has no effect on the ordering of the other. No wonder your results are a little off 
the wall. 


How do you fix this? 


you are here ► 
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need a new data structure 


Associate the name with the score 


Using two arrays just won’t cut it. You need some other data structure to hold 
your data in such a way that the association between the surfers’ name and their 
score is maintained. 


avv-aY 

sorbed 

sdoves-- 



scores 


Bu 七七 scores y\o lemyr 


\A/V^a*b 70 U v\ccd >s 
sornctWm^ tha 七 
looks V»kc 七 W ， s. 



You need a different data structure. But which one? 


%ehok，s tenet 





Al^hy \rows 

o( daia 


zy 


乙七 ly two 

£.oluw\K\S of 

^aieMtd data 



Pa*t^ S*t\rud*tu\rc A 5七3的 da\rd method of o\r^d)aizj^^ d 
dolle 匕 * tioh of dd 七 d i*tcm^s *m you\r dompu*be\r’s mcmo\ry. 

You vc already mci o^c of 七 he dlassid data s*bru 匕七 u\res: 
■the array. 
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hashes and databases 


• + 

Match the data structure names on the left with their descriptions on 
the right. We’ve already done one for you. Which one do you think 
you’ll need to use for the surfer data? 









for holding data 


Set 


A variable that creates a chain of data 
where one data item points to another 
data item, which itself points to 
another data item, and another, and 
so on and so forth 


Multi-dimensional array 


A variable that contains a collection 
of unique data items 


you are here ► 
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hash it out 







— 亀羣 - 


rtcvcs i\\t 



Array 


You were asked to match the data structure names on the left with 
their descriptions on the right. You were also to identify which one you 
thought you might need to use for the surfer data. 


A variable that allows data to enter 
at one end of a collection and leave 
at the other end, supporting a first-in, 
first-out mechanism 


Linked list 



Multi-c[!mens!onal array 


A variable that contains data arranged 
as a matrix of multiple dimensions 
(but typically, only two) 

A variable that has exactly two 
columns and (potentially) many rows 
of data 


A variable with multiple indexed slots 
for holding data 

A variable that creates a chain of data 
where one data item points to another 
data item, which itself points to 
another data item, and another, and 
so on and so forth 


A variable that contains a collection 
of unique data items 


P7JW ^ovld 
as a 

Use a hash 

You need to use a data structure that maintains the 
association between the surfer score and the surfer name, 
which is exactly what a hash gives you. There are lots of 
surfers with lots of scores, and you need to maintain the 
association between the two pieces of information. 



Bits 


Hashes go by different names in 
different programming languages: 
mapping, dictionary, associative array, and 
key-value list, to name a few. In this book, 


Let’s take a look at how hashes work. 
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This du*U doy/n oy \ 


we’ll stick to using the name hash. 


i\)C amou 灼七 of ar>d saves ouv foov 














hashes and databases 


Associate a key with a value using a hash 


Start with an empty hash: 


^ Kote use ^ 

scores — {} 


^ *' s ass.^cd b> a 
vanakle tailed ^ 

scores 


The kc^s 50 



You add data to an existing hash by describing the association between the key 
and the value. Here’s how to associate a surfers’ name with their score: 



Put the key inside the 

sc^av'C b^adkets... scores[8.45] = 'Joseph' 


/\ w/ vow o-(* is ddded *to 
i\\t kasii. hloic *tV>c assodiat'io^- 





how -the o( dssi^hih^ a 

value io a key CREATES tk hash 
⑶ tiry fassumihg its hot already 
tKcirc). |h Pythoh, there’s ho 
CXp|idi*t appthdO” method -PoV" 

hashes 3s "thc\rc is -Po\r 3V"V"3ys. 


yoi/ are here ► 
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iterate hash data 


Iterate hash data with for 

Let’s add some additional rows of data to your hash: 


scores 


scores[9.12] 
scores[7.21] 



is 


sccwm^ly 'random ovdc'r, 
W 七 doA 祕 Y a “七 
七 ha 七 k 灼 。… • 


Once you have a hash created, you can use the trusty 
for loop to iterate over each of the rows: 


Tk w kcvsO w built — m ^od 代 tums a” a^ay 

i\,t keys hi ncv-c av-c e 士 a pomts 

jucssmj y/V^at tv^c %aUsO” method docs. 




Jskc c ^h ihc 
kc y s -the hash 

… *tuirh... 

for key in scores.keys() 

print (scores [key] + ▼ had a score of ▼ ___ 

...a^d display a tusW ^ 

. C ssa 3 e usmj tV,e data h> a value asso^ied with a k C v 价 

叩⑽ b^ke-ts ( ju si like you did with Ly d^) 


str(name part)) 


•m v-ow *tVic ^as^. 



£iIp rrlit r.hpjl |>FhiJf] nplmn'i, Winrinw^ 


ttev^s y/V^a*t would 
display oy \ screen 
(dssum'rn^ dll *b^c 
data "m \esulHV 
was available bo 
hash). 



Josepn ftad a score of fi .43 
Juan had a score of 0 . L 2 
Z d.r_ k hd.J cl ij£ 7.21 

Aaron had a jcorc ot 

iV. 1 -I TL IlrilE fli : m:[jr 4~7 [Jr ft . Q r K 

Jotinny ft ad a acorc oi 

lSL ri,t ： E-;^ Siriil rt [iT 7 i. R 1 

»> I 


Another hash method, called items () ， returns each key-value pair in turn, 

and can be used with the for loop, too: -r,. …， 

〆 - *t" S ° ‘ s 從 h 

key—value pdiv*. 

for score, surfer in scores.items() : 

print(surfer + * had a score of * + str(score)) 


Whichever method you use to iterate over your hash’s data is up to you, 
because using items () or keys () produces the same output. 
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hashes and databases 




Code Magnets 

Rearrange the code magnets at the bottom of the page to complete 
the program shown below. Rather than using two arrays, this 
program stores the results from the surfing contest in a hash: 


result—f = open("results.txt") 
for line in result—f: 

(name, score) = line.split() 


result—f•close() 

print("The top scores were : ") 



you are here ► 
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surfers with their scores 



Code Magnets Solution 

You were to rearrange the code magnets at the bottom of the page 
to complete the program shown below. Rather than using two 
arrays, this program stores the results from the surfing contest in a 
hash: 


^as closed c 岬切 away. 

scores = {} j 

result—f = open("results.txt") 
for line in result—f: 


(name, score) = line.split() 

result f.close() 



Use a W loop 
-(jo pv-otess 七 

tOY\itY\b> 

七 he hasW 


print ("The top scores were :’，） 



out y\amc 3 r\d sdovc> use 
value o-f as key ok tV^c V^asV^ a^A 

value \aw\e” as 七 1^ value. 

、 ， 

Youll -fi h d oui Soon why -the w 

扣 d , 卜 W ham C w is used U -this 
^ as -the key o( ihe hash. 


print ( 1 Surfer 1 + scores[each_score] + scored 1 + each—score) 




p*,sflay eddii v-ow -fv-om {\\t 
dcsdv">bur\^ "tiic assoda 七 -’o 灼 . 



Dumb Quest! 


9ns 


Can I append data to a hash just like I did with an array? 


Can I use anything as the key of a hash? 


Yes, and no. There’s no append () method for hashes 
like the one included with every array. To add a new row of 
data to an existing hash, use code similar to that used in the 
solution, above. Hashes do have their own set of methods, but 
append () is not one of them. 


No, you can’t. The rules Python applies here can be complex 
(as they can be in other programming languages, too). The best 
advice we can give you is to stick with numbers and strings as 
keys. Trust us: this isn’t as restrictive as it first sounds and is, by 
far, the best/easiest strategy to follow. 
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hashes and databases 



Tesr DriVq 


Take the code from the previous exercise and use it to create a new file in 
IDLE. Gall your program scores—hash • py. When you’re ready, press 
F5 to run your program. 



tcora&_lhach.py - /hcm^barryp/KaadFKretProgychspt4r^cod«/EcoraG_hach.py 


Hip frtif Fnrmflt Run Opt ion \ Wmrtfvw^ 
acore h - y 

rI. f ■= ^ " r ill L.ii . I s.I " J. 

t-oi line result_t; 

[nnmK r ■■smu J 1 i nr:. npl i t - . ^ J 

scorescore 1 - name 
rcault_f■close ㈠ 

print ( "The top score a weze-; H J 

each 一 serore ■■: i scores. fceyg ( |i : 

print ( 1 EurCcr _ - acorcs[each score] 












Greats Your program now uses a data structure that allows 
you to associate two related pieces of data together. 


you are here ► 
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sort the surfers 


The data m'i sorted 

Your program now associates surfers and their scores, but 
it displays the data from the hash in some sort of random 
ordering. You need to somehow sort the data in the hash 
to find out who actually won the contest. 


Python hashes don't have a sort!) method... 

In Python, hashes are optimized for speedy insertions and even 
speedier look-ups (searches). As a consequence, the good folks that 
created Python were less interested in providing a method to sort a 

一 一一 \ 





but there is a function called sorted!) 


t II <f.hd dcsia^j a h d — 

, d ^ ,s,0hS …此 w 如 — 

U 9 ua 9 «. People ^ WW..U 

thc PW …峰 3 they ^eaic. 


Obviously, there’s a need to sort a hash so, again, the good folks that 
created Python decided to provide a really smart built-in function 
that has the ability to sort any data structure, and they called their 
function sorted () . Here’s how to use the sorted () function 
with your hash: 


Wse so\rtedO” -Puhdtioh -fco sov-fc the 
keys <A the Wes” hash. ^ 




Remember ： keys m you\r V^asV^ arc 
stores, \n\\\cM av-c so v/c ask 

w so\rtcdO W *to ovdev 
lowest usmj w \rcvcv*sc ^ Tvuc - 


for each—score in sorted(scores•keys(), reverse = True) : 

print ( 'Surfer ' + scores[each score] + ' scored ' + each score) 


That’s one small change to one line at the bottom of your program. 
So, let’s go ahead and make that change. Now that you are 
sorting the keys of the hash (which represent the surfer’s scores), it 
should be clear why the scores were used as the key when adding 
data into the hash: you need to sort the scores, not the surfer names, 
so the scores need to be on the left side of the hash (because that’s 
what the built-in sorted () function works with). 





Make the change to your 
code to use sorted (). 
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Tesr DriVq 


With the one-line change applied, save your program and press F5 to run it again. 



ficorae hash £ort4d.pv - /hoarryp/KeadFEretPr-^g ； cpt^r^c 


Die Dlit Fflrmat Bun Options Windows 


acore b — j ] 

re ault_f - DphCCk( ' z csu lta. tict" ) 

r^i line . z ： re 3 ult_l : 

{name P score) - line. |i 

scores[score ] 二 name 
rcault_f.cloac (\ 

print [ "Tfta top scores were s ™ J 

■t rnnh ■ncinri^ ( rwcinr^t?* . k.fty.'v ) r rftuff rf\n — Tmi 

print E 'Surfer 1 + scores\aacH score] + " scored ' 



丁 s£.o\rCS 3\rc 3ssoC-i3*tcd 

siAV--Pc\r ； s 3r\d 

■bV^cy av-c y\o^i sorted) *too| 


Fantastic! You’ve identified the top 3 
surfers. Time to hit those waves, dude! 



TV^at makes i*t -tWcc- 

\ro>M -fov J[aBv\! 

vou arfi hfim ► 
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more complex surfer data 


Whew data gets complex 


Hot on the heels of your success with the local surfing club, you’ve 

just been contacted by the Regional Surfing Association (RSA) and 

they want jow to write a new program for them'. RSA’s offering a 

brand-new ， state-of-the-art, epoxy resin surf board as payment... 

once the program’s working to their satisfaction, of course. ^ - TWis、 s to° ^ 

You’ve been wanting to try out an epoxy board for ages. The of-fcv "to 


trouble is, they’re sooooo expensive and you’re a poor surfer. The 
waves will have to wait (yet again). But, the thoughts of surfing an 
epoxy board … now that’s worth waiting for. 


So what does RSA's data look like? 



Currently, RSA’s data is stored in a text file using a proprietary 
data format. For each surfer, there’s six pieces of data recorded on 
each line in the file. 

Here’s what the data looks like: 


_ a 代 W ⑽ s oUaU 


101;Johnny 1 wave-boy * Jones;USA;8.32;Fish;21 
102;Juan Martino;Spain;9.01;Gun;36 
103;Joseph 'smitty' Smyth;USA;8.85;Cruiser;18 
104;Stacey O'Neill; 工 reland;8.91;Malibu;22 
105;Aideen 1 board babe * Wu;Japan;8.65;Fish;2 4 
10 6;Zack 'bonnie-lad' MacFadden;Scotland;7.82;Thruster;26 
107;Aaron Valentino;Italy;8.98;Gun;19 


Competition ID. 

Name. 

Country. 

Average score. 
Preferred board type. 
Age. 



scpa ^ ,h 9 ^ daia 


RSA has tried importing this data into their favorite spreadsheet 
program, but that didn’t really work for them. RSA wants a 
program that allows them to quickly find a surfers 5 data based on 
their Competition ID, then display the surfers’ details like this: 


da-ta • 七 em 
\ s 於均 'abded. 



Each data item is displayed 
oh i*ts ov/h I'rnc ； whidli makes 
it \rcally easy v-cad ^like 
tk packed daia -file). 
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厂 fs^^rpen your pencil_ 

Here's one surfer's data from the file, assigned to a variable called line: 

line = "101;Johnny * wave-boy * Jones;USA;8.32;Fish;21 

Grab your pencil and write some code to process this line and display it on screen like this: 


ID: 

101 

Name : 

Johnny 

Country : 

USA 

Average : 

8.32 

Board type : 

Fish 

Age : 

21 


wave-boy 


Jones 


Hints: If you pass a string parameter to the split () method, the data is cut where the string parameter 
occurs, as opposed to the cut occurring at a space character (which is split ()'s default behavior). Also, 
consider using multiple-assignment on the left side of the assignment operator when assigning more than one 
name-value pairing to a hash. 


you are here ► 
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data display 


Sharp your pencil 
K Solution 


Here's one surfer's data from the file, assigned to a variable called line: 


line = "101;Johnny 'wave-boy * Jones;USA;8.32;Fish;21" 

You were to grab your pencil and write some code to process this line and display it on screen like this: 


ID: 

101 

Name : 

Johnny 

Country : 

USA 

Average : 

8.32 

Board type : 

Fish 

Age : 

21 


Cut the lihe o-p 

cvevy time the splitO 
method sees a semi^oloh. 


Hcvcs ovnC possible 々 WW 


Ortdkt ay\ 

以 tailed V. 


l’me 二 {{ IOljJohr\y\y 'wave—boy ； 

;二{} . 


Use multlflc- 
assi^mCir>*t b> assi^ 
*tKc split daia *fv-om 
w lme w -to V. 


(srid’], srhame’], srdourrbry’], sravcragc^J, srboard’], sC'agc^) =■ Ime.spliW) 

- . ^ . 


"+ sC\d^ 


Display six widely 
-fov-maited messages 

oy\ sd\rccr>. 



” + sCVame]) 

J pvm*W U Gouh*brY: 

” + sC^ouh-tvy^J) 

败 ay: 

” + sraverage^]) 

prm 七 (“Board -type ： l， + sdard’]) 

jp\rm 七 
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Tesr DriVq 


As always, you need to enter this code into IDLE before you run it. Then, save your 
program and take it for a spin by pressing F5. 



'display. 



e/b strry p/H«adFl rstPro^/ch apter5/tad py 


£ilp £flrt rormflt Ritn OptifWTi 遇 inrinws 

= n 10 1 ; Jutujjjy 1 pjjctvei-buy ' Jujitrs 61 - 13!;; F 丄 .3]:Lg 3,I_ 

^ = {> 

s[ 'iLtinu?' b[ ^ounLxy ^ ] F s[ = liiMf ▲ apli L ( 


U^P 


pi 丄 ] 化 （ "ID: 
print ( 11 Noetic ■: 
piiaiL ( "CullcsLi. ^ : 
print ( "fevcraqc-s 
prinL ( ,J 3uax.d Ly _«*; : 
print ( 


Hcy ， tw«s data »s y^ovi 
^ rca 山 

^ 、 


u + 2f[ ■ 丄 tl. J} 

B + 3 { ^ nirr.c 1 J ) 
m ■+ a L-uursLi^ ' I j| 
" + 3 [ 1 average * " 

n + 3[ 'LH-JdLJ' ] J 

■_ + Dl^gc'n 


Python sholl 


Die Ldst SheJI IJebug Qptrons Window 5 


JJelp 


JJython J . 1.1 JrJIH Va^HWr Aug 

J RCf! 4i ^ 1.1 ] on 1 i mix ? 

Type ■copyriqiit" f n credit b " or 

IB U ； 3U5 ： 1^^ 

"IicenBS( ) ™ tor .'more inlonnation , 

■n.rid'mi. DH 5 * 

- - - - 


- KLii^I A hl ---- * ------ 

ID: 

IQl 


Majne : 

Johnny ■wave-Uoy" 

Jones 

CountEys 

USA 


Avt?i.€iy tf : 

E.12 


Board type: 

Fiah 





»> | 




J\ 


!Ln. 1? Cnl: 4 


Your code works for one line of data. But RSA wants to be able to 
display the data for any surfer，not just wave-boy’s. 


you are here ► 
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function to hash 


Return a data structure from a fuwctiow 

Processing one line of surfer data was pretty straightforward. But now you have 
to work with all the lines of data in the file. Your program has to make the data 
available quickly so that a request to display the details of a particular surfer can 
be performed as soon as possible. 

You already know enough to write a function that takes the surfer ID as a 
parameter, searches the file one line at a time for a matching ID, and then returns 
the found data to the caller: 





There are really only two choices for how you return data from this function. Pass 
back the surfer’s data either: 



As a string 


or 



As a hash 


But which? Returning a string requires the calling code to further process the data to 
extract the information it needs, which (although possible) gets messy, because the calling 
code is then required to cut up the string using split () . This is something best left to 
the function, because it hides the complexity of manipulating the data from the calling code. 
Returning a hash allows the calling code to simply pick out the information it needs 
without too much fuss and without any further processing. 


Return a hash from the function to keep the calling code simple. 
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Code Magnets 

Rearrange the code magnets to complete the function required. The following 
functionality is implemented: 

1. Accept a single parameter (the surfer ID). 

2. Process the data file one line at a time, creating a hash from the line on each iteration. 

3. Compare the parameter against the ID read from the file. 

4. If the IDs match, return the hash to the caller. 

5. If no match is found, return an empty hash to the caller. 


def find—details(id2find) : 


for each—line in surfers_f : 


surfers_f.close() 


surfers_f.close() 





you are here ► 
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process the parameter 



Code Magnets Solution 

You were to rearrange the code magnets to complete the function required. The following 
functionality is implemented: 

1. Accept a single parameter (the surfer ID). 

2. Process the data file one line at a time, creating a hash from the line on each iteration. 

3. Compare the parameter against the ID read from the file. 

4. If the IDs match, return the hash to the caller. 

5. If no match is found, return an empty hash to the caller. 


def find details(id2find) : 


so you 

v-cad 



Use u -Pov- w i 

for each line in surfers f : 

°°P "though 

，h -Pile.. 



Make sure V^asV^ starb out empty. 


s [ 1 id 1 ] f s [ 1 name 1 ], s [ 1 country 1 ], s [ 1 average 1 ], s [ 1 board 1 ], 

s [ 1 age 1 ]) = each_line.split( M ;") 


Chcdk i-p -the ID 
supplied as a 
is "the 3s ohC 

\read -P\rom -the -file. 





surfers—f.close() 

have a So, dost 

-f lic 灼 \rc*tuv*ir> 

duvvwt hash *to dal lev*. 


Cui up ihc Tmc (usmj spliiO) a^d 
assiy 七 he data -to -the hash (usm^ 
rwultipIc-assi^rwCht). 


return(s) 


surfers f.close () 


return({}) 



y? the c ^ c 

， but +ou h d fs/o 霜 CW. 
Close Uc ^i| c ahd , cWh ah 

c ^pty hash. 



Download surf ing_data . csv from 
the Head First Programming website before 
continuing. Be sure to put the file in the 
same directory/folder as your code. 
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Ope 


Here’s some tester code that weVe cooked up especially 
for you. This code will let you test your function: 


Ask ihc uscv- -Po\r the 

suv-^IDioW ^ lookup—id = int(input("Enter the id of the surfer : 
ufi , , /vl surfer = find details (lookup id) 

Call Vmd dctailsC ； ^ - 


OY\ 


•the cy>*tcv-cd suv-fcv IP- if 



|-f ddid was -four\d, 

七 he _ 

•w>at*tcd messages. 


display 
•forma 七 


surfer : 
print( n ID: 
print("Name : 
print("Country : 
print("Average : 
print("Board type : 
print("Age : 


+ surfer['id * ]) 

+ surfer [ 1 name']) 

+ surfer[* country *]) 
+ surfer [ 1 average *]) 
+ surfer['board']) 

+ surfer [ 1 age *]) 




Tqst DriVQ 



Type this tester code, 
together with your 
function, into IDLE. Be 
sure to put the function 
near the top of you file, 
so that this tester code 
appears after it. 


Make sure the tester code and your function are entered into IDLE and saved 
to a file as a new program. Press F5 to test your function. 


surfer 

IP a^d pv-ojram 


displays details. 




匕专饮 a hohcxis-tch-fc 
ID ahC | i hc 
pV-oj\rary» displays 
^o-thihg (as hc^rcs — ^ 
-to display). 7 



Great work! Your function is working well. Wonder how the RSA 
folks feel about it? 
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surfing success 


Hcr^s your new board! 

The RSA folks are delighted with your work. 



I might actually get 
some beach time this 
year! 


Look at how quickly it 
pulls up each surfer's 
data. 


I think the guys over 
at TVN might want to 
take a look at this... 


Your program really hits the mark. The RSA folks can display 
the data from their tightly packed data file in a way that makes 
it easy for them to read and work with. It’s fast, too. 

Your use of a hash within the function was an inspired choice. 
The calling code only needs to be aware that a hash is being 
returned from the function to work with it effectively. And, as 
you’ve seen, returning a data structure (like a hash) is as easy 
as returning any other variable from a function. 




( 一 -you\r b\ra\r\d 

nev/ board … s*ta\rt 
v-'ipp'mj "it dude! 


Word of your programming skills is spreading 
far and wide. 
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Meanwhile doww at the studio. 



You come highly 
recommended from 
RSA. We have a very 
similar requirement at 
TVN... would you consider 
selling your code to us? 


Head First TVN is an up-and-coming sports 
network specializing in everything and anything 
to do with water. They are covering the National 
Surfing Championship and want their TV 
presenters to be able to use your program to 
access each surfer’s details in much the same 
way that RSA did. There’s just one small kink in 
their plans: TVN has all their data in a database 
system, not in a file. 


The TVH CBO 





Which part of your program is most likely to change if you have to get the 
surfer data from a database, as opposed to a file? 


you are here ► 
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all in the details 


The code remains the same; ifs 
the function that changes 

Your program expects the find details () function 
to return a hash representing the surfer’s details. Rather 
than the function searching the file for the data, it needs 
to search the TVN database, convert what the database 
provides to a hash, and then return the hash to the 
calling code. 

All you need to know is which database system TVN 
is using and how to access it from your function. 

Let’s base your code on TVN’s code. 



Cope 


Here's the TVN code: 


|w>po\rt *t^c s*tair\dav-d nQ 

^ ^import sqlite3 

r»bra^ry 

data m i\\c database 
-f ile you 

download -rv-om *tW»s 
book ； s y/cbs*i*tc). 



I asked our technical 
people and they told me we 
use SQLite3... whatever 
that is. They also gave me 
some code for you to amend, 
they told me you’d know 
what to do with it, which is 
just as well because ifs all 
gobbledygook to me! 



db 


sqlite3.connect( M surfersDB.sdb") 



Pv-o^css o-f 

vows... : 


db.row factory = sqlite3.Row 
cursor = db.cursor() 
cursor.execute("select * from surfers M ) 
rows = cursor.fetchall() 


...look'mj -fo\r a 
SuV"-fcV" V/V^O hdS 

IP o-f \ 0 ^ 


for row in rows : 


dll the suv-fcv 
-Pirom -the 

"Uic dd£c) "to s 
乙 ailed Vov/s^. 


104 


if row['id'] 

print( n ID is " + str (row['id'])) 
print("Name is M + row['name']) 
print("Board-type is M + row['board']) 
cursor.close() 




ou 七 

some 

data (i-f v/c 


Tidy up a-f-tev- youv-scl-f (always a ^ood idea). 
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hashes and databases 


^Sharpen your pencil 


Rewrite your function to retrieve the data it needs from the TVN 
database. Use the ready bake code as provided by TVN’s technical 
people as a basis for your code. Bear in mind that your program 
expects the data in the hash returned from the 
find details () function to be a collection of strings. 


you are here ► 
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grab the data 


^Sharpen your pencil 
^ 7 Solution 


You were to rewrite your function to retrieve the data it needs 
from the TVN database. You were to use the ready bake code as 
provided by TVN’s technical people. You were to bear in mind 
that your program expects the data in the hash returned from the 
find details () function to be a collection of strings. 




find . .dciaiUCidifed)! 


dll -the su\r-fcv" 
-P\rom the 


.d.b. 三. —士 卿 

.=f.itd.R<w . 


database, as opposed^^ / „ ，、 

io the ^ilc. 7 . 、 … .^spr.=i.db,A^sov ： C ； 


.Cvivrspr. ^je:C!Ai.c( w sclcC ： i. *. s^c.v ： s!0 


.r.py/s. ==： 


. ^ox. X*px \y>. yoyos' . 

|/VV^ a maUh is . 7 - 77 ^. y ： ^.C\d!J = •=r.id 2 r-( ： i»)d : . 


s 


•{}. 


sCid/J . ?r.. 5 七 r(y ： w.D.d’ . 


...Wild i^as^ ov\t . I sCV^i^.c^ . J 

kcy-valuc paiv* a 七 a 

■time. ...、......\.... sC^pw^itvy .1 == ： .r.pwr.cp.w.ir.y!l 


sC.avcy ： A3c3.=T. .^(rpy/riSiycragc J). 


.冬 Cb. 9 狀 d:]. 狀 d:l 


==■ 也 ( 广 ?0 w. 


Rctu^ the hasK. 

■to the dalliha__ 、 丄，、 

.j f , P " \rctu\nr\Cs ； 

to&t (as bc+ovc).. 〆 . 

Cursor.dloscO 


\re*tu\nr\({}) 
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Tesr DriVq 


Change your program in IDLE to use the new version of the function (which now talks 
to TVN’s database). Save your program under a new name and press F5 to run it. 


cqllt93-fiiidlt.py - /heme/barrypyHaadFlrstProq/drap 


£jIp fflif rnrmflt Run Options 



: T.r o r ^ aqlitcd 

let tir,d_£lcta ils [ idZtindj : 

[ 3 ti s rn|I i l.i-l ^ircinni^czL, ( " ■■■ 13 Tm ■iTi'fl . • ilh ' ]j 

dJ3. ro-w_ta.ctory - ogiite：S ■ Wow 

E：ur ^E>r a. ilh^i>Li-r »Eii j ^ 

ciiroor. execute^ •'sic J ■■ 二 -st - tros aunt era 

riiwM = [：uir neir ^ fE-:t.i：liuil 1 f h 

i ,:r row in rows 
r nw[ ' ill' 

B 







Download surf ersDB . sdb from the 
Head First Programming website before 
running this test drive. 



python shell 


U 

?i[ ' iii 1 J 
e t 1 n aone e | 
,-i [ 1 r.nn rit r 
0 [■ averaq 

.1 [ ! bt>Pirr3 1 

at ( aqe ' \ 

r.ur^nr -cil 
rei jr n j| s) 
czur-ior _czl ( j 

ret'jnM n ] 

looltup_i(3 — int」input 

surfer - find_aetaila 

,f len( surrer] > 0: 
print ( "ID: 
print [ H Hajiie : 
print ( "Country: 
print £ n iveraqe : 
print ( 11 Do ard t ype 
print ( "Aq 0 ! 


File frlit r .hpli Dphufi Hnlmn '； Winrlnwi 



I'ytftQn i.1^1 (rJll: Aug 1U ^^ l 3 t 

fGCC ^.3.3J un linun2 

Type ■ copyriglit 11 F M credit □. ■■■ or n liccnuc { 厂 tor core intormation 

»> -i^L±-==a==J=====na - jLL_==tr==Ej==r RFISTMIT 

»> 

Etii.Mr I Ism j rl iif l.Yt r ^llt Fb-m i 1 f>? 
lilt 

tlri IHM I .Turm Hl'ilE'l!. 1 ESC] 

Uoantryi Spain 
A vk i ^ . fll 

Hoard tyM s Unn 

HHJI 1 ；! Ifi 

»> —— ------ —- ^ - " —— HESTART 

»> 

Enter trie id o£ the STirten 2SU 

»> 一 - —- - —— - - HnRTftRT 

»> 

Unlirr i r 3 nf thr ； nn rff . r i 10 ft 

1U1 lUh 

Miimr ：x * 7 fink * bmTmi n,rf p HrtrFrtrfrirss 

Country 1 ； ^CDtiand 
Avrrn-gm 7 ^ ft 1 ? 

Board types Ttiruecer 
Age is 2G 


Now, as well as working with data in files, you can extract data from a database 
system. Your program fully integrates with TVN 5 s SQLite3 technology. 

Send off that code to TVN, and sit back and wait for the 
money to roll in... 


\ 

7~V)C pv"Oj\r3w> disfUys simiUv 
ou*tfu*t "to be*fon.. o\r\ly, *bW»s 

t»mc, i\\t data is ^o\ 
a database, NOT a -file ： 
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data in the spotlight 


IWs data is on the mowcy! 


With the surfing data now displayed directly from the TVN 
database, the sports writers no longer need to worry about all 
those tattered and torn competition entry forms. The data 
is right there on screen when they need it. They couldn’t be 
happier. Your program has made their day. 




The TVH spov-ts 

khow how io 

^clcb\raic. 
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My guys are happy 
and so am I, Who 
do I make the check 
out to? 














hashes and databases 



Your Programming Toolbox 

You’ve got Chapter 5 under your belt. 
Let’s look back at what you’ve learned 
in this chapter: 


sK W - a 办 ?: 二 M * 

a ^：； ^ ^ • a 
US — 以一 

一广二冰如一一 

氺 3 

O U i^o\o^ 

㈣ 



Py*thoh Tools 

决 f} - Cmpiy hash 

* Wj - ^ sho ^ „ sch hai va|uc 

: 工7一。 k 〒“ e 

t s 'tl _ ^ d v a ,is " °" kcys m ^ 

sp,i ^ 

:' tU ihe line 沾斷 y o, £ u^ e ^ 

* T^f ° 7 a 卜托一 … ^^*'oh that dah sov-t 

啪 。 St data sWWs 
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6 modular programming 



The code that you write will make its way into many programs. 

And, although sharing is good, you need to be careful. One programmer might take your 
code and use it in an unexpected way, while another might change it without even letting 
you know. You might want to use one function in all your programs and, over time, that 
function’s code might change to suit your needs. Smart programmers take advantage of 
modular programming techniques to keep their workload manageable. Let’s find out how 
in the pages that follow... 


this is a new chapter 




technology upgrade 


Head First Health Club is upgrading 
some systems 


Head First Health Club has a new CEO, and he loves new 
technology. He was shocked when he saw how old the sales 
systems were. 




个 

Old dwd Wstcd 




Some of our technology 
is really ancient. I want to 
start by replacing the cash 
registers with new POS 
systems. Can you help? 


"The old Ush ircjis'tc^s 

v^ally heed -to be v-cpla^cd. 


TV^c ^ s'/s 七 cm wll _ 
挪 a PC ad aac ? 七 

tar A 



The hew ho*thcss 


A point-of-sale (POS) system is just a computer program that 
works like a cash register. The boss doesn’t want to replace all 
of the cash registers immediately. He wants to begin with a trial 
system in the coffee bar. 



Let’s see what the coffee bar POS needs to do. 


I 七 would be hide i-P the systems 
you pvodude wc\rc r^odulav- ih 


Y^ull get io ihai 

AFTER you've speh-t some time 
uhdcvs-bhdmg whats v-e<\ui^ed. 
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modular programming 


The program needs to create a 
trawsactiow file 

The POS program will record credit card sales in a file called 
transactions . txt. At the end of each day, this file is sent 
to the bank and any money is transferred from the credit card 
account into the health club’s bank account. 

The bank has sent an example version of the file for you to see 
what sort of data you will need to generate: 


The l^> dha\radic\rs avc 丁 k 7 丁 k -follow. 

"the dvcdi*t 匕 av*d i^umbcv-. ^ ave the pv-i^c. 、 



The file contains formatted data. There’s a line of text (or 
record) for each item sold. The first 16 characters of the line 
are the credit card number, followed by 7 characters that 
represent the sale price, excluding the decimal point (so SI.75 
is written as 0000175). The rest of the record is a description 
of the item being sold. 





How would you create a string of characters in the correct format for the 
record? Which parts of the record will be the hardest to create? 
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string formats 


Use strings to format strings 


Many programs need to create strings with particular pieces of data 
at particular places, so most computer languages try to make life 
easier for you by letting you use string formats. 

The best way to understand string formats is with an example. Open 
up the Python Shell and type in this: value w.ll 

be ihscvtcd as a 

»> print ("There are %5d %s available" % (17, 


TKc second value Will be 
^ mserbed as d sfm ， 

'donuts")) 


There are 


17 donuts available 


The Kas cx.*tva spades 

added a*t *thc *to make 

suve *rt -takes up i\\C vc<\u*i\rcd ^ 
dKavattcvs. 

When Python sees a string followed by a percentage (%) symbol, 
it knows that it needs to consider the string as a string format. 
The values that follow the % operator are going to be inserted into 
the formatted string in the order specified, one value at a time. 
Wherever Python finds a % inside the string, it knows to insert a 
value. 

A hurwbc\r -fov-mat 
spedi-pidatioh 一 ^ %5d< 


When Python sees this, it will insert the value 17 as a 5-character 
whole number — that’s because the “d” type specifier tells Python 
to print the number as a decimal. Because 17 is not 5-characters 
long, Python will left-pad it with 3 extra spaces at the front to make 
it the correct length. 




This symbol tells Python to insert the value “donuts” as a string. 
As you are not specifying a length here, the string is inserted as is. 



The stv” -* foma 七七 … 3 

o\>cv-a*tov- 


OK y this string is 
followed by a % symbol. 
So... ril need to replace 
%5d with the number 17, 
and %s with the string 
'donuts". 


O 


o 




These are just two examples of how to format 
values in a string. There are lots more. 
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modular programming 


■f 


• + 


Match each format string to what it does. We’ve already done one for you. 


%s %e" % ("Value is" , 16.0 ** 0.5) Display a string followed by 4.000000. 



%s is $%4.2f" % ("Popsicle", 1.754) 


with spaces. 


Pad the string out to 20 characters, then display a 
newline character. 


%s %f’▼ % ("Value is" , 16.0 ** 0.5) Display the number as a hexidecimal (base 16). 


%07d" % (11232/3) 


As well as a string, also display a floating point 
number to 2 decimal places. 


Sharpen your pencil 


Be ^airc-Pul wi-th -the 

de 匕 poiht ih -fchc 


Look back at the records you need to create for the transaction 
file. Each line will need to end with a newline character. If you 
have the credit card number, price, and description in variables 
called credit—card, price, and description, write 
down what you would use for the format string: 
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format string 


1 

Lr^r 




l-f you have jus 七 
ov\c value -to -Pov-mai, 
you Aoy!{, need "to 
suv-v-ou^d it v/i 七 h 
pav-c^-thcscs. 


+ MC10 亀麗警， 




You were to match each format string to what it does. 



%s %e" % ("Value is", 16.0 ** 0.5) 


%7d" % (11232/3) 



Display a string followed by 4.000000. 


Display a string followed by 4.000000e+00. 



"%x n % 127 
、 r^cahs iakc a 

, %20s\n n % "Banana swirl 
This means w usc \ tV>a\rad*tc\rs. w 

"%s is $%4.2f" % ("Popsicle", 1.754) 

TWis mea 灼 s u sV^o>w 2 - numbers 
*tV^ dc6w>al fomt 

"%s %f" % ("Value is n , 16.0 ** 0.5) 

Values csv\ be *tV>c 」 
v*csul*t d £.al£.ula*tioy>. 

” ％ 07d” % (11232/3) 

Followmg the % with a O 
•^^hs w pad v/itli 2^v-ocs >； 


Display the value, padded with 0s. 


Display the result of the calculation, padded 

with spaces. __ — ^ default, Pv^o^ Will ?ad 

us'm^ spates. 

Pad the string out to 20 characters, then display a 
newline character. 


Display the number as a hexidecimal (base 16). 

_ 

As well as a string, also display a floating point 、 
number to 2 decimal places. 〜 ％ ac lc6mal wumfeevs 

av-c used -fov- *bWmy 
like tolov-s oy \ -t^c lA/cb. 


Sharpen your pencil 


^ Solution 

Pov /七 wovvy * 1 -(* youv- av>sy/cv- docs^*t 
look E^ACTL^ like *tV>*is. Tvy out youv 
a^swev - m Py 七 ho 灼 Shell *to dKcdk 

七 ha 七 ••七 v/ovks. 


You were to look back at the records you need to create for the 
transaction file and write down what you would use for the 
format string: 

a*ispla 7 *m 3 as a ^olc 卿 Acv 
c-f-rct*tWclY v-cwovcs 
dc“al i\\c 


u 7o|is7o07d7o|is\h W % (^redi 七一 Urd, prided IOO, description) 


Credit £>dv~d y>umbcv*s should always 
be c%ad*tly l^> tV>avad*tcvs. 




>u r\tt& a ncwlmc dhavadiev- 

a-t 七 he c^d <^P eadh Ime. 
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modular programming 



Code Magnets 

Now that you know how to format the records in the 
transactions . txt file, it is time to write the rest of the coffee 
bar POS program. Complete the code below by arranging the code 
magnets in the correct place: 


def save_transaction(price, credit_card, description) : 
file = open("transactions.txt ", "a" ) ^ - 


w a w you art always 
y>i h??tUV rtCords 

■to f ile. 


file.write("%s%07d%s\n n % (credit_card, price * 100, description)) 
file.close() ___ 


This is the -Po\rma-t sVmg you jus-t 


items = ["DONUT", "LATTE", "FILTER' ，， n MUFFIN n ] 
prices = [1.50, 2.0, 1.80, 1.20] 


running = True 

while running : 
option = 1 
for choice in items : 


option = option + 1 
print (str (option) + ". Quit") 


if choice = 

= option : 

else : 



TV^ loof Will kccf while 

vav"i3blc 

〆 value TVue. Ti ⑼ d 如 loop, se 七 
w \rurmi\r^ "to False. 


save transaction (prices[choice - 1], credit card. 
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new pos program 



Code Magnets Solution 

Now that we know how to format the records in the 
transactions . txt file, it is time to write the rest of the coffee 
bar POS program. You were to complete the code below by arranging 
the code magnets: 


def save_transaction(price, credit_card, description) : 
file = open("transactions.txt ", "a") 

file.write("%s%07d%s\n M % (credit_card, price * 100, description)) 

file.close() 

>^TW»S is i\\t a 叫 j m ⑽ 

items = ["DONUT", "LATTE", n FILTER n , "MUFFIN '，]( 
prices = [1.50, 2.0, 1.80, 1.20] is 七 he 狀 My o*f 

running = True 


while running : 
option = 


This toAt displays -the 



print(str(option) 


Quit") 



^J\\t USCV aWs a 
^ make a sale. 


if choice 


option : 



^^This will be Tyruc i-P -the useir selects the LAST 
optioh oh the mem, whidh is %uit. w 


else : 


credit card = input("Credit card number : M ) 
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modular programming 



Tqst DriVQ 


The machine has been set up in the coffee bar just in time for the 
boss to come in for his morning latte, so let’s run the code and see 
what he thinks. Run the program in IDLE: 


gJ# £dit ,hp|l Qptkm 


3 a Q m 1 

[«€ 4^1,2] t! 


ia s e a：] 


丁 he sales a\rc v-c^ov-dcd ih 
七 he 七七 x 七 

4/ 



rob 

帥 linux3 

I |c：R|uiff [ I ' marm 4 n f csrluE. j.pri<-v 

RESTART ■■■■■111_ 歐 ___11 — —— 

>>> 

b . 咖 vr 
IJLTfC 
x r r il . Tiqi 
4 . MUTTia 
tHiX 

n A -ftTilL inm s 7 

CfTfldit: eb!TE£ nusbeETS 
Id^MUT 
LAiTE 
j, rii^EB 

5 ^, Quit 

litywnn rui ra^i^iiaf; 

Cc«dJi b ^«rcE nlasers 


The program displays a list of items for sale and when you choose 
one and provide a credit card number, it adds the sale into a file 
called transactions . txt. This is the same file that the POS 
system in the gym uses. 


akes suve sales avc 
recorded on scyaraic I'mcs. 
(v/ou ta^-b see m 

-file, Ut -t^cy arc tVicrc.) 



The boss agrees to try out the system in the coffee bar, and he even 
agrees to extend the trial and let your friend create another POS 
for the gym, based on your code. 

Things are going really well. If they continue like 
this, you will win the contract to replace all of the 
systems at the health club! 
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real-world format strings 



The Pwmstt 

This week’s interview: 

Why do appearances matter? 


Head First ： Format String, it’s a pleasure to meet 
you. 

Format String ： The pleasure is all mine. 

Head First ： You’re not just used in Python, are 
you? 

Format String ： Oh no. I’m really used in lots of 
programming languages, like G, G#, and Java. You 
see me crop up all over the place. 

Head First: Why is that? 

Format String ： Well, I don’t like to blow my own 
bugle, but I am kind of useful. Everywhere you need 
to generate formatted text, I can make life a lot easier 
for you. 

Head First ： Gan you give us some examples? 

Format String ： Oh sure. If you need to send data 
to another system, you’ll probably need me. If you 
want to display an error message in a specific format, 
I’m good at that, too. 

Head First ： I hate to say this, it seems so rude, but 
isn’t it possible to do everything you do with just 
normal string operations? 

Format String ： Please, I don’t take offence. Yes, 
you can do pretty much everything I do by writing 


code and creating strings manually. But I don’t think 
that’s a great idea. 

Head First: Why ’s that? 

Format String ： Two reasons: first, you might have 
to create a lot of code, and second, I’m a little more 
dynamic. 

Head First ： What do you mean? 

Format String ： Well, I’m just data. Lots of times, 
programmers prefer to use data instead of chunks 
of code, because it means they can store me away 
as configuration. So I get used a lot for things like 
internationalization. 

Head First ： Internationalization? 

Format String ： Yeah, say someone wants to display 
a message that someone has the top score. They 
could write the message in a file like “％d is the top 
score!”. If they write a French version of the game, 
they just have to amend me to “％d est les points 
superieurs!” 

Head First ： No code change necessary. 

Format String: Exactly. 

Head First ： String Format, thanks for your time. 


theretcire no o 

Dumb Questi9ns 


Those format strings look a little 
weird. How do I find out more about 
them? 

A good reference book (we present 
our favorite in the appendix) will contain all 
you need to know and there’s also lots of 
material on-line in the official Python docs. 
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Are there special rules for what’s 
acceptable as a credit card number? 

Yes, there are. But let's not get 
bogged down in those type of details at this 
stage. Concentrate on the 
save—transaction () function 
and how the code interacts with it. 


Why does the code generate the 
menu in such a complex way? 

If you study the menu generation 
code, you will see that when you add more 
items and prices, the rest of the code 
doesn’t need to change to support the new 
items.The menu is generated automatically. 




modular programming 


A late wight email rums your day 

A few days after the demo, you get a late night email from the 
friend who wrote the second program (based onyour code): 




_播 一 




Hi, 


:=r: n 。工； 

code- ifs with your POS program running in the coffe _ 

sort things out. 


s 


See you in the morning! 


Something really strange has happened. Even though your code used 
to work, it has suddenly started to go wrong. Meanwhile, your friend’s 
program, which is really just a modified copy of your program, is 
working perfectly. 


Looks like you better get to the health club bright and 
early tomorrow morning and see what’s happened. 
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pricey donut 


令 50 , 000 ... for a dowut?! 


When you arrive at the health club you find out exactly what’s 
happened. The entire day ? s sales have been rejected by the 
bank for two reasons: 



The credit card numbers are all fake/invalid. 



The bank was really worried about this one because they think someone 
must have hacked into the system to generate the messed-up credit card 


numbers. 



The prices are ridiculous. 

One of the recorded sales was for a donut that cost over $50,000! 


And what makes it worse, this 
was the first time we sent the 
transaction file to our new bank! We 
only switched over the day before 
yesterday so that I could secure a 
loan for the new weight room! 


This looks like a really serious 
problem. Let’s take a look at 
the file that the bank rejected. 
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Owly the sales from yrn program 
were rejected 

The transactions . txt file that was sent to the bank contains all 
of the day’s sales from ho\hyour POS program in the coffee bar and 
your friend’s POS program in the gym. This is a section of the file: 



This is the 
Mfcc bav was 
REJECTED by -the bahk. 

〜 _ 


50791428746281510000150 


00035005002454912715921 



As expected, each record (from each of the POS programs) has been 
appended to the transactions file. That bit appears to be working fine. 


V>av^* 


But，something is not quite right here. 





Study the two records carefully. Is there a difference between them that 
might explain why one was accepted and the other was rejected? Think 
about recent events. What do you think has caused this problem? 
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change in format 


The new bank uses a new format 

Your friend tells you that just after taking a copy of your code, the word 
came down that the health club was switching banks. Without telling j ⑽， 
your friend found out the new bank format and updated his code in the gym 
program. 

That means that the POS program in the gym is generating records in the 
new bank format. 

The new bank format is: 


Price / Credit Card / Description 


TWis is -the jVS.OO. 

0003500 


TW»s is i\\t 

tavd 

^_ 

5002454912715921 


/ Tk W ? 寸 s a 



OK, thafs another 
workout sold, so ril write 
Price.... then Credit Card., 
then Description... 


O 


0 


The bank accepted the transactions from the gym because 
they were in the correct format. 

But what about the coffee bar program? 
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modular programming 


Your coffee bar program still uses 
the old format 


Your program in the coffee bar was never updated after the health club 
switched banks. It’s still doing what it always did: it’s still creating files 

in the old format. 

That old format wrote out the price and the credit card the other way 
round, which meant when your program wrote out a record like this: 


So thafs a donut. 
Better write Credit 
Card... then Price... 
then Description. 


丁 he ^v-edit 亡 dv*d humbev 

_ 

5079142874628151 


?r\U 二 

0000150 


_r 

DONUT 




The new bank read the record like this: 


The phde... &0,T}l •今 Z! 




5079142 


㉗/二仏匕: 工 ke . 


8746281510000150 DONUT 



Bui ai least 七 he 
dcsdvip-tioi^^s OJs. 


This is suspicious... 
$50,000 for a donut.... 
Does not compute... Fake 
credit card information! 
Security! Security!! 


O O 


So it’s not that somebody broke into your program and changed it. 
No, it’s the exact opposite. Your code never picked up the change that 
was made to the gym program in order to support the new format. 




What should you do to fix it? What shouldn’t you do? 
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don't copy, share 


Pow't just update your copy 

The code in the gym program is a copy of your code in the coffee bar. 
And copying code is a bad thing. Once you have two separate copies 
of a piece of code, then changes need to be applied in two places. 
So how do we avoid copying code? 


Smart programmers write modular code 

The secret is to break your programs into smaller pieces of code 
called modules. What’s a module? It’s just a file containing code the 
computer can run. Every Python program you’ve written so far has 
been a single module. 

But most programs you’ll write will probably be split across many, 
many modules. And writing modular code is important because 
modules can be shared between programs. 


O 



0 



transactions, py 





If you separate out the code that saves the transactions to a file and 
store it in a new module called transactions .py, that module 
can be shared by both programs. If you then ever need to change 
the code in transactions .py, both programs will pick up the 
changes automatically. 


192 Chapter 6 









modular programming 


So how do you create a module...? 

Remember: a module is just a file containing some Python code. So, take the 
code that you want to share out of the gym_pos . py file: 



Then save this code in a file called transactions .py. You have just 
created a new module. 


...and how do you use it? 

Once you’ve created the module, you then need to tell the programs to use it. 
When you were using library code you needed to import it. You do the same 
thing with your own modules. So, instead of using library code from the 
Standard Python Library, you’re really just using library code that you’ve 
written yourself. You can add this line to the top of each of your programs: 


TW»s m 


J his lihC -to be added . 

f-m transactions import * ^ 


n 

youv pvoyarw. 


With this line, you are telling Python that you want to run the code in the 
transactions . py file and this allows you to access whatever code the 
module contains as if it is just part of your program. 

It’s time to fix the programs. 
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tale of two programs 


^Sharpen your pencil 


TV^is »s i\\t code *to 七 ^ 



These are the two POS programs. Here is the code to the one 
used in the coffee bar (that you wrote): 


def save—transaction(price, credit—card, description) : 
file = open("transactions•txt", "a") 

file.write("%16s%07d%16s\n n % (credit—card, price * 100, description)) 
file.close() 

items = [ n DONUT", "LATTE", "FILTER", "MUFFIN"] 
prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running : 
option — 1 

for choice in items : 

print(str(option) + n . " + choice) 
option = option + 1 
print(str(option) + ". Quit") 
choice = int (input ("Choose an option : ’▼)) 
if choice == option : 

running = False 
else : 

credit_card = input("Credit card number : n ) 

save transaction(prices[choice - 1], credit card, items[choice - 1]) 
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modular programming 


The other program is very similar (which your friend created for use in the gym): 

def save transaction (price, credit card, description) : 


JVis is ihc code -to the 

3y 州一 pos.py” P 呼如 . 


file = open("transactions.txt ", "a") 

file.write("%07d%l6s%l6s\n" % (price * 100, credit_card f description)) 
file.close () 


items = ["WORKOUT", "WEIGHTS", n BIKES n ] 
prices = [35.0, 10.0, 8.0] 
running = True 

while running : 
option — 1 

for choice in items : 

print(str(option) + ". " + choice) 
option = option + 1 
print (str(option) + ". Quit") 
choice = int(input ("Choose an option : ")) 
if choice == option : 

running = False 
else : 

credit—card = input ("Credit card number : ’▼) 

save transaction(prices[choice - 1], credit card, items[choice - 1]) 


Using a pencil, modify the two programs so that they use the transactions . py 
module. Then write what you think should go into the transactions . py module here: 
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transactions module 


— <P^ 



Sharpen your pencil 

Solution 


These are the two POS programs. Here is the code to the one 
used in the coffee bar (that you wrote): 


savi^t^aTTBaction (price ； ~~ticdiL_cdicT f ― CteSuiipLion) :— 

、 file - upe 丄丄 （ n Lieu 丄 5 actioTTs . ^lla-U) 

、f ~i I i I ,h ( M -o TTj ^ r A 0 7 l ] n 1 h m I P" % ~ (rrredi t_c j rc4 — pi iu'e*— 1 ^ 60, - description) > 

~ r 丄 ly. uloco() 



items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running : 
option — 1 

for choice in items : 

print (str (option) + ". ’▼ + choice) 
option = option + 1 
print(str(option) + ". Quit") 
choice = int (input ("Choose an option : ’▼)) 
if choice == option : 

running = False 
else : 

credit—card = input ("Credit card number : ’▼) 

save transaction (prices[choice - 1], credit card, items[choice - 1]) 
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modular programming 


The other program is very similar (which your friend created for use in the gym): 



card, ― d'ebuiipLtuii) : 


r iIs — """"crpuii ■( n tnransa-C L . L21L 


一 file • wi 丄 Le ( MD o07d%'WiD 9 olGb\ii M ~ % —"^price TUTT r creair_cdid;~~description)) 
r 丄 lu . clOii 1 二 （） 



items = ["WORKOUT", "WEIGHTS ”， n BIKES n ] 
prices = [35.0, 10.0, 8.0] 
running = True 

while running : 
option — 1 

for choice in items : 

print(str (option) + ". " + choice) 
option = option + 1 
print (str(option) + n . Quit") 
choice = int(input("Choose an option : ")) 
if choice == option : 

running = False 
else : 

credit_card = input ("Credit card number : ’▼) 

save_transaction(prices[choice 一 1], credit—card, items[choice 一 1]) 

Using a pencil, you were asked modify the two programs so that they use the transactions . py 
module. You were then asked to write what you think should go into the transactions . py 
module here: 




-file w\ri*tc( w %07d%l ^>s7o| % (pride 决 100, d\rcdi*t — dav-d, dcsd\rip*tioy\)) 


-filcdloscO 



1 - 
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test drive 




Tost DriVq 


Once you have completed the exercise, you should have three saved 
files: gym_pos . py, cof fee_pos . py, and transactions . py. You 
can now run the gym_pos . py and the cof fee_pos . py programs: 


py 



Python shell 


Flip frlit f.hHi Hphnns Winrlnw i- 


jjplp 


i'ytfton i. 1.1 (rJil: Aug Ui ) 

m! im 1 imiK? 

'lypc _ copyrignt n r "crcdita" or n ii 口 en.ae (厂 lor more information 
»> ====================== H FSTAHT ============= : 

»> 

1 . Un^KOSIT 

1 , STFnR 
i. guit 

fllnon.^^- rtri ■np'hi nri : ] 

Credit card numbez ：!； 643242 ^ 412^71 1 . 

1. WORKOUT 

2 . WEIGHTS 

3. BIEE5 

4. Quit 

Chooac an option : 4 


on Sh«IK 




£ile Ldrt SheJI Uebug Dptions Windows 


JJelp 


Python i. 1.1 (rJlls ^11V0 P Ayg 1U 
[<Wf! 4 . U I cm 11 mix? 

Type ■copyriqtit" r " credit h " or w 1 ice fih 0 [ ) " tor rMre inta-nna tion 
>» -- RESTART ——- 

li DOHUT 

2. LATTE 

3. FILTER 

4 . MUFFIEJ 
5i Quit 

Cliuuiat: an L xuii : 1 
Credit card numbers 

1 . nowtiT 

2 . LATTE 

1 , rrr.TnTi 

4 , HUFiaw 

5, Quit 

cnooEe an optIon : ^ 

»> s 


In: iml: d 


The two programs look like they’ve worked 
correctly. But what about the transaction file? 
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modular programming 


The trawsactiow file is working great too 


When you open up the transactions . txt file, you see this 
inside: 


丁 k -Pilrs-t 7 

the p\ridc. ^ 


The 灼 ext I 厶 dhava^-tc\rs avc 
"the dvcdi't 匕 dvd 灼 urwbev*. 

A 


The dcst\rif*bior\s follow. (Not 
七 he c%*tva faddrnj due *to i\\ 
w %l W 》 ovw>a*t sfc6-f 'ic\r ) 


t 

t 



Both of the records, created by each of the POS programs, are now 
correctly formatted. That’s because both programs are sharing the 
same piece of code to save the transactions. 


Phew! I just heard from the 
bank that transactions from 
both of the POS systems went 
through smoothly. That*s a big 
relief. Good job fixing it! 


Looks like you saved the day. 


ihere^e no ^ 

Dumb Questi 9 ns 



So modules are sort of like 
containers for functions, right? 

It’s true that most modules are used 
to store a collection of related functions. 
However, it is perfectly acceptable to 
put any code in a module, which is then 
executed whenever the module is imported 
into your program. 


So when I use import, it’s as if I 
typed the code in the module directly 
into my program? 

Yes, that’s a good way to think about 
it. Using a shared module saves you from 
having to type (or cut’n’paste) all that code 
yourself. Just import it and it’s there. 


Do I have to use modules? 

No, but the benefit of putting 
shareable code into a module starts to 
pay off the second you use that module 
in another program. Sharing code with 
modules is good programming practice. 
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price break 


The health club has a new requirement 

The health club boss has a grand plan to get more customers into the 
health club. 


O 



m 


Ooh, I think we need to discount the 
prices in the coffee bar for the next month. 
There's nothing like relaxing with a latte after 
a tough workout, especially if the price is right. 
Our customers like to treat themselves, so I 
want to make this easy for them. 



The boss has a great new idea. 

The boss wants to cut 10% off all the prices in the 
coffee bar. If it’s successful, he may want to do the 
same thing in other places, such as the gym. 

Instead of just amending the code in the 
cof f ee_pos . py file, you need to create a new 
module called promotion . py that will calculate 
a discounted price. 
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modular programming 


^Sharpen your pencil 


You need to change the coffee bar POS program to apply the 1 0% 
discount to everything that’s sold. You have three tasks. 



Start by creating a new module called promotion . py containing 
one function: 


def discount(price) : 


o 


Complete the code in the above function so that it returns 90% of the price it is 
given. 



This is the latest version of the cof f ee_pos . py module. Modify it so that it 
uses the new module to cut the price of everything that’s sold. 


from transactions import * 

items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 
running = True 

while running : 
option — 1 

for choice in items : 

print (str(option) + n . " + choice) 
option = option + 1 
print(str(option) + n . Quit") 
choice = int (input ("Choose an option : ")) 
if choice == option : 

running = False 
else : 

credit—card = input ("Credit card number : ’▼) 

save transaction(prices[choice - 1], credit card, items[choice - 1]) 
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discount applied 




^Sharpen your pencil 
l Solution 


You needed to change the coffee bar POS program to apply the 1 0% 
discount to everything that’s sold. You had three tasks. 



Start by creating a new module called promotion . py containing 
one function: 


def discount(price) : 

\re*tu\rh ^ pride 


Mult'i 
4^ Will 5 


七心 •” 七 ^ W 的 


:ive Y ou 


a 


|07o distouy\*b 


• • 


❺ 


Complete the code in the above function so that it returns 90% of the price it is 
given. 



This is the latest version of the cof fee_pos . py module. Modify it so that it 
uses the new module to cut the price of everything that’s sold. 


from transactions import 

-fvom promotion inr\po\rt ^ ^ - 



You i\tt& -bo imfov-t todt 
-from module. 


items = ["DONUT", "LATTE", "FILTER", "MUFFIN"] 

prices = [1.50, 2.20, 1.80, 1.20] 


running = True 


while running : 
option — 1 

for choice in items : 

print (str (option) + n . ’▼ + choice) 
option = option + 1 
print (str(option) + ". Quit") 
choice = int (input ("Choose an option : ’▼)) 
if choice == option : 


running = False 
else : 

credit_card = input("Credit card number : 

— 13) ^ - 


Youv- Code should 

tall *bV^c u disdoiAir\*tO ; 


(\AY\tk\OY\- 


save—transaction ] , credit—card, items [choice 

— 」>咖 ^ is' t he di Wed value the 


- 1 ]) 

plridc. 
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modular programming 



Tost DriVq 


So what happens if you fire up cof f ee_pos . py in IDLE and buy a %2 latte? 



It looks like it’s working on the screen. What about in the transactions . txt file? Will 
the latte still cost S2.20? 




00001983489203918924782 LATTEL 

-二— J 


No, the latte was discounted by 10% to SI.98, which is exactly what you 
want to record in the transactions file. 

It’s time to demo your code to the boss. 
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another discount 



o 


0 


Thafs fantastic! 

You made the change 
so quickly, just in time 
for the doors to open. It 
does handle both kinds of 
discount, right? 


L // 



Both kinds of discount? 

It seems that there was something that the boss forgot to tell 
you. As well as deciding to cut the health club’s own prices, he 
also got in touch with his old friend, the GEO of Starbuzz, 
and arranged for a special discount for everyone who shows 
the cashier a Starbuzz Discount Card. This is the email he 
received back: 


lire ? ■■助 frrt 

Great to hear from you! _ discount scheme! A lot of 

Yes, of course, 二 re now working on systems for Starbuzz, 

SO I tmnljcan help your^ 

lf we ever change 

^- d o any wo, ， a,U 

Be well and keep drinking the coffee! . 

Your friend, 

Starbuzz CEO 




That’s great news. Although you’ve heard about this extra discount 
late in the day, at least most of the work’s already been done for you. 
You just need to use the Python module the Starbuzz CEO attached 
to his email, and your program will be set up to apply both discounts. 


Let’s take a look at the Starbuzz code. 



.. 
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The Starbuzz code 


The attachment from Starbuzz was a file called starbuzz .py. 
When you open it, you see this: 


"that s-bv-t with 

养 Py-thoh 

will ighov-c -them. 


TW«s »s ^ 

d\sdOUV\"t 
as ^\rov'«dcci ^ 
S-tavbuzi. 


# Official Starbuzz Discount Module 

# Copyright(c) Starbuzz Corporation 

# All Rights Reserved. 

# This function calculates a 5% discount on a price 
def discount(price) : 

return 0.95 * price 




The first few lines begin with # characters; these are comments. 
Comments are just notes added by a programmer that are intended 
to be read by other programmers. Python will ignore them, because 
comments are not code. 


TWis \rc*tu\nr\S d …以 

七弓 % loy/cv* fvitc i*t 

y/ds 


After the comments comes the Starbuzz discount () function. It’s 
just like the discount function you wrote, except instead of returning a 
10% discount, it returns a 5% discount. 

Your code will have to use both discounts: 




It will apply a 10% discount to everything. 

And if somebody presents a Starbuzz Discount Card, it will also have to 
apply the 5% Starbuzz discount. 





You need to change the code so that it uses both of the discount () 
functions. Can you see a problem? What is it? 
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identity confusion 


The two discount fuwetiows have the 
same name 

Here is the promotion . py module you just created: 



And here is the starbuzz . py module: 



Both of the modules define a function called discount () . So what 
happens when you try to use them? If Python sees a line of code like 
this: 

new_price = discount(1.75) 

which function will it call? The promotion discount? The Starbuzz 
discount? Both? Neither??? 

This is one of the problems of using shared code. Sometimes, there’s 
a function in one module that has the same name as a function in 
another module. When this happens, the last function imported is the 
one used, which has the effect of overloading any existing function 
that has the same name. This can result in to hard-to-find bugs. 

So what do you do? 

You need to somehow qualify your function names. 
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modular programming 


Fully Qualified Names (FQNs) prevent 
your programs from getting confused 


Imagine if you lived in a world where people had first names only: 



Lots of people share the same first name. But people also have 
surnames. If you use a first name with a surname, things are a lot 
less confusing. 


And it’s the same thing with code. If you have two modules 
containing functions with the same name, the computer will get 
confused. But if you fully qualify the function name, by prefixing 
it with the module name, the computer will know exactly what 
you mean: 

promotion.discount(1.75) 


If you are going to use Fully Qualified Names (FQjNs) from a 
module, then you will also need to change the way you import the 
code: 



Oh, I need to 
apply the 10% discount 
from promotion.py? 
Thafs not a problem, 
since you re using a 
FQN... 


o 


import promotion 


TWis v/ill import CoAt ^ 

but -to use *rt, you VMill rtccd *to add W ^omot»o^. 

•to start d Mmc. 



coffee 


Now you can fix the code to use both discounts. 
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smarter pos 



Write a new version of coffee—pos .py that, after choosing a menu option, will ask if the 
customer has a Starbuzz Discount Card. If the answer is “Y”，apply both the Starbuzz and the 
promotion discount. Otherwise, just apply the promotion discount. 

Here is the latest version of coffee pos .py 
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^ouv toAt 

\\CfC 
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getting a promotion 


E*grciS€ - 

flB^goLuttOH 

These are the two discount modules: s^bu2^py 



You were asked to write a new version of cof fee_pos .py that, after choosing an menu option, 
will ask if the customer has a Starbuzz Discount Card. If the answer is “Y”，apply both the Starbuzz 
and the promotion discount. Otherwise, just apply the promotion discount. 

Here is the latest version of coffee pos • py ： 
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modular programming 


By i^povtihg the 

"tv*ahsad*tiohs module like this, -fjrom .*tv ； 3>>Sc|^io|r\S irnpo\r*t ^ 
you d 3 h ddll -the *Puh 乙 "tiohs 

without the module hame. (. P.VP^P.'tloy) 


- 一 .report starbu^z. 

You v>ccd *to use 七 iVis k'md ok \ 

imfovt -fov w pvomo*tior> py 

^y\A w s*tav-buzz^fy w , because 

you 3 。 叫佺 r a\\^ the iWs. .. .=1. CVOMT^ .. TJLIER：V 

*ruy>£.*t'ior> y/rth *tiiC 

prides ==• Cl .50, % O x 1.00, 1.2-P] 


\odule v>3mcs. 


=f- True 




op*tio») I 

-for c\\o\Ct m i*tems: 


•十 . •“• . • ••十 Ah?)#? 


.9f.il 9.^. 77. .option . 十 . [ 




dhoidc .^7. U C))oosc option ： : ：)) 

i-f C\\o\Ct 二二 of*tioh: 


\ruhhm^ ^7 Fcllsc 


else ： 


.^dii^aird =■ hpMi.CCy^ii. .4 奸 4. pwkd 


|-f someone V>3s 3 
S*tcl\rbuz2. Disdourrt 
Cav-d, you v\eed b> 
apply 七 he sttov\A 
S*t3v*buz2. dis£.ouv>*t- 


pride 〒 .r：.!.V 

^TTr^..^. •… .pp •七 uzz. da\rd? ttF::. ^.V.!: 

.PV.'^.rr: starlpuz^disdouh*t(p|ridc) 
sayc^\rahsad*ti 一 4 奸屯 . iic/wsCdhojdc - I J) 
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test drive 




TesT DriVq 


Let’s try running the new program and buy a SI.20 muffin without 
a discount card. 



But what if you try to buy a S2.20 latte using a 
Starbuzz card? 


li ^osi fl.OG — ^ 0 % o( jiZO 























modular programming 


The discounts get the customers flooding m 

Once word gets out that there are double-discounts available in 
the coffee bar, the health club gets packed with customers. 



Weve never been so busy! The weight 
room, the gym, the steam baths. The 
whole place is full of customers! I like 
the way you write code. I want you to 
upgrade every system in the place! 


Thanks to writing modular code, you got the contract to 
replace all the health club systems. Modules help you write 
stable, maintainable code. The more code you write in modules, 
the greater the chance that you’ll be able to reuse it elsewhere. 


Breaking your code into modules turns good 
programs into great programs. 


tWeiare no o 

Dumb Questi9ns 


I don’t get it; why do I need to use 
a FQN again? 

You use a Fully Qualified Name 
(or FQN) when you need to distinguish 
between two functions from different 
modules that have the same name. 

With the health club systems, the 
discount () function existed within 
your module and within the one supplied by 
Starbuzz. In order to keep things straight, 
you had to use a FQN. 


So if I hadn’t used a FQN, the 
wrong discount is applied to the 
purchase? 

Yes, most probably. 

But if I hadn’t used a FQN, how 
would I know which discount was used? 

Well... that's the problem. You 
wouldn't. It's hard to predict what would 
happen, because it all depends on which 
order the code imports its modules. 


So, all I need to do is keep an eye 
on the order when I import modules and 
everything will be OK? 

No, that’s not what we recommend. 
Don't rely on what might happen. Use a 
FQN so that you are always in control. 
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programming toolbox 



Your Programming Toolbox 

You’ve got Chapter 6 under your 
belt. Let’s look back at what 
you’ve learned in this chapter: 


^ e . ?d ^ Aes ,s ta ' ud 

氺 /\Z\oAva^ v 60 t 
氺_七 w 

WWav-*'^* Ns) are 

〆 一 wtWd 



Py^thoh Tools 

* ^ sc “ 舂 d. impov-t io 

todt module -Puhdiiohs 
without module hdmes. 

* Wsc >PC you heed 
^uali+y youv 4h^ioh ^ C s 

with a module hamc usihj dh 

卿 is £hc ^omm Ch dc( 
appvoa^h ih the Pythoh 
^ommuh'rty). 


mds 
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7 bu!ld!ng a graphical user Interface 

’ Going all gooey^ 



Your coding skills are great and getting better all the time. 

It’s just a shame your programs are not that nice to look at. Displaying prompts and 
messages on a text-based console is all well and good, but it’s so 1970s, isn’t it? Add 
some green text on a black background and your retro look will be complete. There has 
to be a better way to communicate with your users than the console, and there is: using 
a graphical user interface or GUI (pronounced “gooey”). Sounds cool, but complex, and 
it can be. But, don’t fret; learning a trick or two will have your code all graphical in no time. 
Let’s get all gooey (sorry, GUI) in this chapter. 


this is a new chapter 









a host of requests 


Head First TVN wow 
produces game shows 

It’s more than just sports at Head First TVN, as the station has 
entered the lucrative world of live game show broadcasting. 

Their flagship show, Who Wants to Win a Swivel Chair, is attracting 
viewing figures in the millions... not bad for a station that operates 
on a shoestring budget. 


You’ve been approached by their stressed-out (but incredibly 
smooth) game show host to help with a program he needs. TVN 
was so impressed with your work last time that they are offering 
two free, front-row tickets to the Grand Final as payment for your 
work. 


I can’t keep track 
of the score and ask the 
questions and sound the 
buzzer... all by myself... 
can you help? 


O 


You’ve had a few conversations with the host and determined a 
list of program requirements'. 

1. The host wants to be prompted after a question has been asked 
to press either 1 for a correct answer or 2 for a wrong answer. 

2. Based on the key pressed, an appropriate sound effect needs to 
play. 

3. The program needs to remember how many answers were 
correct and how many were wrong. 

4. The host will end the quiz by pressing 0. Then the program 
will display the number of right, wrong, and asked questions. 

Let’s flesh out what’s required in pseudo-code. 



sV^ov/ V^os*b* 
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building a graphical user interface 


^Sharpen your pencil 


Use the space provided below to write the pseudo-code for the 
program you’ve been asked to write for TVN: 


pseudo— 6odc 

- 
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game show pseudo-code 


*^Sbarp your pencil 

Solution 


You were asked to use the space provided below to write the 
pseudo-code for the program you’ve been asked to write for TVN: 


.number asked — 0 

You y>ccd *to vcmcmbcv- ho>w 

«yucs*tioy>s >wcv*c asked, hunabcv__do\r\rCd*t ^ O 

hoy/ mdv>Y ^Crt torrtci, / 

a^d how y/circ wirohj. .. r.P... 


h ask *the hos*t {o press I +o\r do\r\red*t> 2- -for *mdo\rvcd*t> oy O {x> tY\d 

V>7 askm^ tv^c / . ’. 

host *to wake a c\\o\tc y/Kilc -the hos 七 vespohse is 竹。七 0 


vgspohsg y/3s 


二⑽齡 . 


i-f hos 七 

add I *bo hu^bc\r_askcdT 
add I io humbc\r_do\rved*t 
flay a sou^d 
i-f hos 七 response y/ds Z 


*^ad I *bo number asked 


TW»s v/'»H .... 

4 *tW <\ucs*bo^ add I *bo humbc\r__w\rohC| 

v/ds a^sv/cvca . ” . J 

IKCORRtCTUV. \ P la Y a.^ 


Ask -the host ai the 

of ca^h loop what 
he wahts -to do hcxt 



ask *the host to pvess I -for do\rred*t, Z -for mdo\rre6*t, or 0 *bo e^d 


display -the values o+ number asked； number toYYtt^ a^d 

fm 御 . ’ . 二 . 二 . 

*t!he stoves- I humbev^wroh^ oy\ sdvcch 


Don 七 wo\r\ry i-p you\r ^hsy/cv* 

doesh't look Exactly iik 

this. Thcvc d\re a -few ' 
o*P v/Htihg the todt- 
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building a graphical user interface 


Frank: I think sound is going to be a problem. 

Jim: Sounds easy to me... 

Joe & Frank: <groan>. 

Jim: Sorry, couldn’t resist that one. Seriously, though, how hard can 
it be to play a sound from a program? 

Joe: Playing a sound is not the problem; getting it to work on 
multiple platforms can be. For instance, what works on Windows 
might not work on Mac OS X or Linux. 

Jim: That’s not a problem. I only use Windows, so I’ll be OK. 

Frank: Good for you, but the rest of us want to play, too, and we 
don’t want to have to... um … eh... downgrade to Windows. 

Jim: Typical: have a swipe at Windows when something doesn’t 
work onyour non-Windows computer. 

Joe ： Cool it, guys. We need to stop bickering and come up with a 
solution that lets us play sounds and works on Windows, Mac OS X, 
and Linux. And it has to work with Python, too. 

Jim: You mean Python doesn’t support sound as standard?!? 

Frank: No, not really. In fact, very few programming languages 
support sound in a cross-platform way. This isn’t just a Python 
problem. 

Jim: So... we’re outta luck then. Does that mean it’s time to go 
home? 

Joe: Not so fast, Jim! I’m pretty sure pygame can help here. 

Jim: So... I can’t go home early, but I can play games? 

Frank: Seriously, Jim, I think Joe’s right. We can use pygame to 
play our sounds in Python. 

Jim: And it’ll work on Windows, Mac OS X， and Linux? 

Joe: Yes, I’m pretty sure it will. Granted, pygame’s a set of gaming 
libraries for Python, but all we need to use is the bit that handles 



playing sounds. 

Jim: Sounds great. I can’t wait to see it in action. 
Frank: Didn’t you mean u hear it in action ”？ 

Jim & Joe: <groan>. 
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get in the pygame 


pygame is cross platform 


Before continuing with the rest of this chapter, you need to take 
five to download and then install the pygame technology onto 
your computer. The pygame technology is an example of what’s 
known as a third-party library: that’s extra functionality that can be 
added into your Python environment, but which isn’t part of the 
standard library. 



As installing pygame tends to be a very platform-specific 
thing, we’ve uploaded a set of instructions onto the Head First 
Programming website for you to follow. 


STOP! Don’t proceed with the rest of this chapter 
until you’ve installed pygame for Python 3 on your 
computer. 
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building a graphical user interface 




Take a look at this handy pygame program, which shows how to play 


four sounds one after another: 


Just like other 
1 'ibv-av-ics, you imfov* 七七 he 
I'lbv-avy Y ou 火 扣七 usc * 


Ortd{,t d U pyjarwC rwi'X.CV- W object 
and mi-tialiic -the sou^d sys-tem. ^ 

The 

•fuM 七 10 灼 loops uy>*t'il *tiiC / 
dha^ers w yt 」 >usY()” 
mC*thod V*ctuV*y>s False- 


The value \rc-tu\r^cd -Pv-orw ^ 
七 he u playO w method gets ^ 

passed "to “wdrt *f mishO”. 


import pygame.mixer 
sounds = pygame.mixer 
sounds.init() 

def wait_finish(channel) : 

while channel.get busy() 



pass 气 - 

s = sounds.Sound("heartbeat.wav") 
wait—finish(s.play()) 
s 2 = sounds.Sound("buzz.wav") 
wait—finish(s 2 .play()) 
s 3 = sounds.Sound("ohno.wav") 
wait—finish(s 3 .play()) 
s 4 = sounds.Sound("carhorn.wav") 
wait finish(s 4 .play()) 


The w ^*t_busyO w 

method diictks *to 
see i-f *thc SO\AY\A 
•is still flay'm^- 


6 o^s*brvA 6 *t 
does y^otWm^ 

Load m 七 he 
sou^d -file you 
yj3v\i io play. 

and plsy 

tacM o-f i\\t sowds. 




To run this program on your computer, you obviously need pygame installed and you 
need to download the sound files for this chapter from the Head First Programming 
website. Be sure to put the sound files in the same directory/folder as your program. 
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test drive 




Tqst DriVQ 


You’ve successfully downloaded/installed pygame and grabbed a copy of 
the Head First Programming sound files for this chapter. Now, test the pygame 
program in IDLE to see if things are working correctly: 



raadivLpy - /hairtiB'barrypyp_ecufid , s^r@ady.py 


£iiIp friit r nrmftt Run Ophinns Winrlnw^i 


pygicic .mixer 

»itiLEi3[]M =3 jiyEjj^mr .m i jii-; j 

souncLB. init {) 

I: wait 一 1 ini[channe! 丄）： 

cihnnnnl ^ huny^ J : 



b - aovindB.Sound( n hearti>Bat .wav' 
wait 一 fini nh ( s . piny()) 

32 專 aounds.Sound( "Husz.wav 
wait_fini5h{a2 *play()) 
a3 s sounds.Sound_ "onno.wav" J 
wait_finioh{a 3.play()J 

= sounds - Sound( n c ar-norn. r -?av n ) 
wait finia>h{a4_pilay(3> 





Buzz! 


Oh no! ^ 


Sounds like pygame is up and running! 


^Beeeep! 


I hear my cheesy 
sound effects... 
you gotta love that 
car horn! 


O 




OWovasV/, w w t 

如叫 OVA SO— … 
tWis book but W 七 
vaS, tWis ^oyr^ 

v,ovks as W\cd. U 

Ul POKT wt 

uS ： \ust V)C SUVC to 










building a graphical user interface 


tliereiare no o 

Dumb Qu©sti9ns 


So pygame is a library created 
by some programmer other than the 
Python folks? 

Yes, it’s what’s called a third-party 
library. It wasn’t created by you or the 
people that bring you Python. Some other 
programmer(s), a third party, created 
pygame. 

And it’s just given away for free? 

Yes. Which is very nice of them, isn’t 
it? 

Are there other libraries like 
pygame that can be added into my 
Python environment? 

Yes, there are lots. To see the current 
list, follow the Package Index link from 
the main Python website. Python refers to 
third-party libraries as “packages” and, as 
you'll see, there are packages available for 
every conceivable purpose, not just playing 
sounds or developing games (as is the 
case with pygame). 

The sounds I downloaded are 
WAV files. I know that WAV is one of the 
standards for encoding sound, but is it 
the best format to use? 

That depends on who you ask! We 
are using WAV files because they are used 
in lots of places and are well-supported on 
most operating systems. There are lots of 
file formats for sound and many of them 
claim to be “better” than WAV, but for what 
we are doing here, WAV is perfect. 


What’s the deal with the wait_ 
finish() function in the Ready Bake 
Code? I just don’t get why it’s there. 

It’s a function that waits for the sound 
to finish playing before continuing with the 
rest of the program. 

What?! Surely the sound just 
plays? 

Playing with pygame in this way, 
although fun, masks a problem that can 
surface when working with sound (in any 
programming language). It turns out that, 
when asked to play a sound, the main chip 
inside your computer (the CPU) doesn’t 
even bother trying. Instead, there’s another, 
smaller chip in your computer that is 
specifically designed to play sounds and 
it is to this chip that your main chip hands 
the sound file to and says: “play this for 
me/’ The main chip then goes back to 
running your code, sees another request 
to play a sound, doesn't bother, hands 
the new sound file off to the sound chip, 
and repeats until your program ends. The 
sound chip—and this is the important 
part—is designed to operate in parallel 
with your main chip. While your main chip 
is doing something else, the sound chip is 
busy playing any sounds it has been asked 
to play. And—here’s the rub—if the sound 
chip has been asked to play more than one 
sound, it attempts to play each sound at 
the same time. 


So the wait_finish() function is 
like an artificial delay after each sound? 

No, not really a delay, more like a 
pause designed to let the sound effect play 
fully before trying to play anything else. 

The wait_f inish () function forces 
your sound chip to finish with one sound 
before starting another. What happens is 
that when a sound is played, the play () 
method passes back the channel (or track) 
number that the sound is playing on. You 
can then use the channel number to ask 
pygame to wait for the channel to finish 
playing a sound before continuing, which 
is what the code in the Test Drive on the 
previous page does. 

And if I don’t use wait_finish(), 
what happens then? 

All the sounds attempt to play at the 
same time and it sounds like a jumble of 
sounds as opposed to one sound playing, 
then another, then another, and so on. 
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beyond pseudo-code 



ExGRdSe 


Now that you know how to generate a sound using pygame, it's time to write the code for 
TVN’s program. Base your program on the pseudo-code you created earlier. 
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on with the show 



jCpm 茛 ExeRciSe - 

SoLutlOH 

Now that you know how to generate a sound using pygame, it's time to write the code for 
TVN’s program. You were to base your program on the pseudo-code you created earlier. 

HA -to . 

二 1 口 . 

. 

^ y/hile dhannelAei bwyO ： 

cav-licv-. . J.. . 

pass 

Cv-ca*tc a objcd*t . 

dr>d ’mrtialiZjC *tV>C - 今 sounds 二 j>y|jai^e 

f>y^ame so\ay\A system. 

souhds.mi 七 0 

Load o-P -the 

\rc^uiv-cd sounds i^-to its do\r\rcd*t_s =■ souy\ds.Souhd^ U do\r\rcd*t wav ) 

ovm variable- ” 

souhds.£ouhd( y/\rohj.y/av J 

This is what you II 
ask the ^ucstioh 

你 ast 饮 time. u * r ^ r „ 

^ pvomip 七二 Press I koY CoYYttX) Z koY Wyoy\^, o\r 0 xo 今 ui 七： 

Make suve dou^ 

WII rnamtam av-c to a . 

veaso 灼 aWc s*bs 矿七 ⑹此 ^hunabev"__dsked 二 0 

number do\r\red*t ― O 

” . 7 ■- . 

It would be 0^ io move -these 一 y/\ror^ 二 O 

I'mcs o-p todt "to the "top 

o*P the pv-ogirarw, just so loh^ Bs 

they have s-birtihg values bc-fov-c 

"the while loop s-tav-ts- . 
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P\romp-t the host 

W，le 七 ^ .!tt. ]Q. : 

ended. .. 

i；f 咖 

l-f *tv>c air>S>MCV- IS 

CoYYtt^) mtv*crwcv>*t *tKc. y\umr\bgv 3skgd ― • ^fArnbcy"__dsked ft* I 


dou^*tcv*s dv>d *tV>cv> flay 
七 lie affv-ofv*ia*tc souy>d. 


humbev 6ovvcd*t 二 humbev- dor\rcd*t + I 


_ 七一 

|-f 七 I 化 a^s>wcv- is 

*mtov\rCd*t) mtv-CmC^*t_- .. . - .^ . AKp| 4?. .TTrn .. 


*tV>c touy>*tcv*s aiad flay 
*tV>e souv>d c-f-fcdt 


number asked — number asked + I 


hunr\bcv- wv*or\<\ ― hunabev- w\roh<\ + I 

• •••••••• •••••• ••••••••••••• • • • • • • • • • • 

mish f>yy ； o^g^s. f jay ()) 


dhoidc =7 


AU^ ⑶ d oUk ?^am, 

display a summav 7 4 t e 

douv^tev- values. 



pr'mt( u Y9^. <ask?d w + ."t. . U . ^Cstior\s. w ) 

^Mrm*t(sbr(humbev*_do\rred*t) + w wcv-c do\r\rcd*tly ahswc\rcd ， 0 
p\rm*t(sbr(humbe\r^w\ror^) + u were answered mdovre&tly/O 
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test drive 




Tesr DriVq 


Type your code into IDLE and save it under the name game show • py. 
With the Head First Programming sounds stored in the same directory as your 
program, press F5 to give it a spin. 



python shall 


£iIp rrtit r.hpjl |}phijf] Hplmn^ Winriowi 

rython 3 B 1. L ( r311 1 7443C , Aug L6 2009, {37:03:4” 
JQCC 4.3,3] uxi 


■^ypc 
>» : 
>» 


'czcdita" or 


liccnac [) n tor r^orc lntormation 
：==== RESTART 



Press 

1 

for 

Correct j, 

2 

for 

^Trong P 

or 

a 

to 

Quit* 

I 

FrBSB 

L 

ror 

Correctj 

2 

lor 

Wronq r 

or 

& 

to 

Quit : 

1 

Press 

1 
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Correct, 

2 
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or 

o 

to 

Quit;; 

1 
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1 
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2 
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or 

& 

to 
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2 
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l 

for 
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2 
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or 

& 

to 

Quit: 

2 
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1 
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Correct ,r 

2 
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or 

G< 

to 

Quit! 

1 


1 
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2 
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or 

Q 

to 

Quit: 

I 
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1 
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2 
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or 

0 

to 

Quit : 

1 
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1 
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2 
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or 

Q 

to 

Quit:: 

1 
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1 

ror 
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7 
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or 

0 

to 
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2 
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or 

0 
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Quit i 
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to 
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or 

G 

to 

Quit: 

1 
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1 
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2 

for 
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OF 

0 

to 

Quit: 
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(or you\rscl*f. 
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building a graphical user interface 



This week’s interview: 

Is it fun being pygame? 


Head First： Hello, pygame. Nice of you to join us. 

pygame： Hello. Thank you so much for giving me 
this opportunity to discuss my situation with you. 

Head First: What situation is that? 

pygame： Well, you know, just because I’m used for 
gaming, everyone expects me to be fun all the time. 
Life and soul of the party... never stopping to smell 
the roses... always on the go. <sigh> It’s all too much 
fun, really. 

Head First： Too much fun? Really?!? 

pygame： Well... yes. Not a lot of people know this, 
but my life as pygame is hard. Not only do I have 
to help out regular folks with their programming 
problems, but there’s all those gamers, too. Some of 
those guys never sleep... it’s just play, play, play, play, 
play, play... I’m simply exhausted. 

Head First： Oh, sorry to hear that. But, don’t you 
feel good that all those programmers out there in the 
Python community are using you? 

pygame: I guess so. 

Head First： You’ve made a lot of programmers’ 
lives easier. There’s lots of great code written that 
would not have been written if it weren’t for you. 

pygame： Yeah, right. I do all the heavy lifting while 
everyone else is off doing other things. 

Head First: Ah, come on, your life’s not that bad, 
is it? 

pygame: <sighs> 


Head First： Surely you know what people are 
saying about you? 

pygame： Now they’re talking about me, too? How 
awful... <sobs> 

Head First： Yeah, there’s lots of talk, but it’s all 
good. The Python programming community loves you, 
pygame. 

pygame： They do? <sobs even more 〉 

Head First： Yes. You are well-tested, well-written, 
and your documentation is first rate. Your support 
for all the major releases of Python is right on the 
money, too, and you work on Mac OS X, Windows, 
and Linux. 

pygame： All I’ve ever tried to do is keep everyone 
happy. 

Head First： And you do. We’ve heard so many 
great things about you that we are recommending 
you to all our friends. 

pygame： Do they play games? I’m good at that, you 
know. 

Head First： Yes, some of them do. But others just 
talk about the great things their applications can now 
do thanks to you, pygame. 

pygame： I guess things aren’t quite so bad after all? 

Head First： Not at all. We’re big fans! 

pygame： Why, thanks. That’s awesome. Do you 
have time for a quick game? There’s this new 
Dungeons and Dragons that I’ve been dying to try... 
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dated interface 


0 ... 1 ... 1 ... 9 ... blast off! 



1, 2, and 0...?!? Pressing 
keys? Really? Thafs so 
1985 … 


Your program’s looking pretty dated. 

The program works, but it’s not going to win a Visual 
Design Award any time soon. And its use of key presses 
makes it a little hard to use, too. 

So, its looks could be improved and its usability could be 
better. 


It sounds like you need a graphical user interface, or GUI. 



Most fcoplc 6(\A\ 


as 


V oe y. 


)) 
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building a graphical user interface 


Sharp your pencil 


You need to design the look of your GUI for TVN. Draw what you 
think your GUI should look like in the space provided below. 

Hint: Take some time to think about other GUI programs that you 
have used. Think about a common interface element that you 
could use (and draw) here. 
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interface facelift 


r^harpen your pencil 
< Solution 


You needed to design the look of the GUI for TVN. You were asked 
to draw what you think your GUI should look like in the space 
provided below. 




Py^SS 

is 



P,r(rss buiU 


you v\ttd *b>/o buttons -fov 
taeM you\r v-ojvam s 
CVCir\*b. 
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building a graphical user interface 


Frank: Since when have you been an expert on GUIs? 

Jim: Isn’t every Windows user? 

Joe: Well, of course, everyone knows how to use a GUI, but we are 
talking about creating a GUI in code. 

Jim: Ah... oh... um... eh... now, where shall we start? 

Frank: It turns out that writing code for a GUI application is... 
well... just like writing any other code. If you know how to program, 
you know how to create a GUI. It’s just a matter of selecting the 
correct GUI library, learning how to use it, then writing the code. 

Joe: So we’ll head off to the Python Package Index and grab us some 
GUI libraries, eh? 

Frank: Not so fast. Python comes with a GUI library as standard, 
called tkinter. 

Jim: tk-what? 

Frank: tkinter. The “tk” bit refers to the fact that Python’s standard 
GUI library is built on top of the very popular Tk technology. The 
“inter” bit is short for “interface.” 

Jim: So we’re going to build a GUI interface in Python running on 
Tk using tkinter? 

Frank: Yes, we are. That’s not too confusing, is it? 

Joe & Jim : Well... not if you say so. 

Frank: The big thing with creating GUIs is understanding the event 
loop. 

Joe: Ah, that’s just looping code that reacts when certain things 
happen, isn’t it? It’s just like the while loop in the non-GUI version 
of TVN’s program. In that code, that loop is an event loop, isn’t it? 

Frank: It sure is. Although the GUI event loop tends to be extra 
capable and can do lots more than the simple while loop. 


Ah... GUIs. All those lovely event 
handlers, mouse clicks, widgets, frames, 
scroll bars, double clicks and—my 
personal favorite—the mouseover. 


o 



Joe: That sounds complex. Is it? 

Frank: No, not really. It just takes a little getting used to. 
Jim: But, it’s all just code, isn’t it? 


Frank: Yes, Python code using the tkinter library. 


Joe: OK. Let’s get to it, since we already know how to program... 
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tkinter event loop 


tkiwter gives you the event loop for free 

In order to process events efficiently, GUIs employ an event loop. Event 
loops watch and wait for events, calling a piece of code each time an 
event occurs. If you think about the current TVN Game Show program, 
it already has a very basic event loop that waits for the host to press 1, 2, 
or 0. The program then calls some code before waiting again for another 
key-press event from the host. To implement this in code, you used a while 
loop: 



In tkinker, you don’t need to write a while loop like you did for your 
non-GUI program. In tkinter, call the mainloop () method instead: 

Impovt -fvom 

module- 


Clidk oh £.losc 
box "to -tcv-rhiha-tc 
仏 is appli^atioh. 


^ivc the 

window 3 


from tkinter import * 

Crcaic a tkmW 

app = Tk () Y/'mdov/ dallcd a?? 
app.title("Your tkinter application") 
: app.geometry('450x100+200+100 ’） 

Pvov'ulc v/mdew 

S-ta\rt the 七 knrrte\r everrt loop. 



TV^csc I'mcs o\ 

p>y 七 W/ 伙… W 6odc 


app.mainloop() 


values. 


To add a button to your application, use code like this, being sure to put 
these two lines of code before the call to mainloop () : 



bl = Button(app, text 
bl.pack() 


"Click me!，'，width 



Add 3 *to 

"Uic v/ihdow vc 

it some text ahd a 
width value. 


The bu-t-toh s bcch 
^dded h> the ^U/. 


The ^3tk0 method Us 
七 he v^cv/Iy seated WWoh 
-to WmdoY/. 
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tklwtcr is packed with options 


The pack () method lets you position the button in the application 
window. If you provide a value for the side parameter to pack (), 
you can control where in the window the button appears. Here are the 
legal values for side: 

• 

pack(side = 'left A ) 

Position the button on the left side of the window. 

• 

pack(side = 'right') 

Position the button on the right side of the window. 

• 

pack(side = 'top') 

Position the button at the top of the window. 

• 

pack(side = 'bottom') 

Position the button at the bottom of the window. 


The value of u sidc w 
^ohi\rols whcv-c -the 
tu-t-toh is packed. 




It is also possible to add some padding around buttons (to make them 
look nicer in your window): 




pack(padx = 10, pady = 10) 

Position the button with 10 pixels padding on all four sides. 


^harp your pencil 






Based on what you now know about tkinter windows and 
buttons, write the code to display the GUI that you need for the 
TVN program: 
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gooey display 


Sharpen your pencil 
K Solution 


Based on what you now know about tkinter windows and 
buttons, you were to write the code to display the GUI that you 
need for the TVN program: 




Cv-ca*tc *tV^c y/'mdov/ as 
*m i\\t cavlicv 
bu*t w'mdov/ 

•brblc a^d yowbry 
values. 


app.^.TkO . 

^PP ： !tiiJie;( u T\ / hf £1)0^) 


^ -Pov- 

^ u Co^r cv Ch i bl BuiWapp,. M ^ Xorrttil^ .y/idiK \Q) 

?at\c k 七仏 ?7.. .y.^k(sidc ^ Ic^iVfad% ^ \0 K pady )0) . 

OY\ *thc *thc / 

o*thc\r oy\ "the / . 

Jaaatj ihcm so " c \^..bZ.^MWapp A ^ 

Cveatc a^o-tV^cv N ^.. .b? ： -.p3dk(sidc ==； pad%. ^ . I O, pady. =： . I O) 

‘ 咖 y / S l ⑽七. 


S*tav-*t -the eveirrt loop - rr^. .^.pp. ^!^)9.9?(? 
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Tesr DriVq 


Let’s take your first GUI program for a test drive. With your tkinter code 
entered into IDLE, save it as tvn . pyw and press F5 to see how it looks: 


to&t Ipi—^ 


TVicv-c s a CoY\^tv\hov\ \y\ *tV^c 
y/ovld sujjcs-b nammj 七 ev* 

Yroyra^s ^i\h\ a w 
as opposed to W\t usual w fY * 丁以 
klfs youv- ofcvatmj system ^ youv- 
i\C\v\itr pv-ojvams fv-ofcv-ly) csfc^ally 
^/mdoy/s. 



,pyw - /home/barryp/p sounds/tvn.py w 


File Edit Format Run Options Windows 


Correct! 


Wrong 


Look'm^ jood, cV^? 


...a 灼 di "bV>cvc av-c 

youv *bwo buttons. 


Help 


from tkinter .■ ?ort * 


app = Tkf) 

app. title ( "TVN Gaioe Show" ) 
app. geonaetry ( 1 300X100+200 + 100 1 ) 


b2 = Button{app f text = r, Wrong ： " f width = 10) 

DZ .pacx{side = ' r±qht ' # pads = iW, pady = iuj 


bl = Button(app, text = 'Correct ! 

bl «■ poscjk (side ■- 1 left 1 ji pat±K — 10 


ThcvVs you\r 与 U| wihdow … 


app.mainloop() 


r width = 


， pidy ■ 


TVN Game Show 


That’s one nice, professional-looking GUI! What do the 
people at TVN think? 
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beauty without brains 


The ftUl works, but doesn't do awythiwg 



Nice interface, but it doesn’t work. 
When I click on a button, nothing 
happens... I don’t hear anything. What 
happened to my cool sound effects? 


The graphical user interface might 
be ready，but the program is not 
complete. 


tJiereiare 

Dumb ( 



esti9ns 


So all tkinter gives me is the ability to draw the GUI? 

Well, yes, but there’s quite a lot of functionality wrapped up in 
that small number of lines of tkinter code. 

That pack () method looks a little weird... how does it 
know where to put things? 

The pack () method adopts a best-guess approach when 
it comes to packing your GUI widgets within your GUI application 
window. This usually works out, and when it doesn't, pack ()'s 
parameters give you some control over the situation. 


That’s all that left, right, top, and bottom 
stuff, isn’t it? 

Yes, as well as the padx and pady parameters. They 
help with widget positioning, too, by putting additonal space (or 
padding) around your buttons. 

OK, I get that, but how come nothing happens when I 
click on my buttons? 

Ah, funny you should ask that... 
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Connect code to your button events 


When you click on a button, the tkinter event loop captures the event and 
looks for something to do with it. The trouble is, as your program stands, you 
have not detailed what that something to do is. Your buttons have no code 
associated with them, so the events occur but go unnoticed. To connect code to 
buttons, put the code you want to run in its own function and then name the 
function in the button code by providing a command parameter: 


Idc^ii-fy 七 he -to 

七 he bui^tto 灼 is disked. 




v*uh 



Cv-ca*tc a ^v\choY\ -to doniam 
dodc \ruhs >N\\tv\ 
CVCir\*t od^UV-S. 





elkk on 
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■python shell* 


JJeJp 


««P[] 




d€ C &utton_cIict [J 3 

print I "1 1 vc juat been clicked 


b - Dutton< app t text :■ n Cliclt on me L 

b. |j-cad：x = 10, p-ddy = 10 |i 


wi dth - 15 i command - but t on 一 click} 


Eun Qptiofis Endows 


11 严 


n PP- 


"ni-irV nn nw- H f 
app.qeam£it;ry [' 100x100*200^-100 




Oil 


n 


[■Ip I flit rihpj! rjphy n Optenns 


jjplp 


I'ytftiin i. 1.1 (rilix Aug m suj ： 4!s) 

[QCrl i . li. 3 ] Bin 1 i Eiiix? 

Type 1"copyright r, P "credita" or m license (] fi tor more intormatiem 
»> =\,======~==— ================== BKRTART ================== 

>» 1 

T ■ vk J u?s t. c:l i ■丄 


fi fa Cm 


I ： 


Thc Uu 


匕咖 ed. 


■I hrk nn 
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making connections 


Sharp your pencil 




The code from the nongraphical version of theTVN program is on 
this and the facing page. Take your pencil and mark the parts of 
the code that you would extract and turn into functions so that 
you can then connect the functions to the buttons in your GUI. 
Mark the other parts of this program that also need to be added 
to the GUI version. 


yovided by 

6\U\ medv^s -tKa-b some — 
have ^a^cd- 


Note: Don't worry about prompting the host to ask a question in 
the GUI. But do worry about maintaining a count of the number 
of questions answered correctly and incorrectly. (The total count 
is not important, either.) 


How many functions do you think you need? Write their names here: 


import pygame.mixer 

def wait—finish(channel): 

while channel•get—busy(): 
pass 


sounds = pygame.mixer 
sounds.init() 

correct_s = sounds.Sound("correct.wav") 
wrong_s = sounds.Sound("wrong.wav") 

prompt = "Press 1 for Correct, 2 for Wrong, or 0 to Quit : 

number—asked = 0 
number—correct = 0 
number wrong = 0 
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choice = input(prompt) 
while choice != 'O': 
if choice — '1 1 : 

number_asked = number—asked + 1 
number—correct = number—correct + 1 
wait—finish(correct_s.play()) 
if choice — '2': 

number_asked = number_asked + 1 
number—wrong = number—wrong + 1 
wait—finish(wrong_s.play()) 
choice = input(prompt) 

print ("You asked ’▼ + str (number_asked) + ’▼ questions . n ) 
print(str(number—correct) + " were correctly answered. n ) 
print (str (number wrong) + ’▼ were answered incorrectly. n ) 


With the code you need identified, take the time to update 
your GUI application with the new functions and whatever 
other code you’ve extracted from the non-GUI program. 

Produce a new program that is a combination of your existing 
GUI code and the extracted code from this program. 
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page goal header 

r %Jiarpen your pencil 

Solution 


You were to take your pencil and mark the parts of the code on 
the previous (and facing) page to identify the code you would 
extract and turn into functions so that you can then connect the 
functions to the buttons in your GUI. You were also to mark the 
other parts of this program that also need to be added to the GUI 
version: 


You were to think about how many functions you might need. You 
were to write their names here: 


”1 ， 一一 sound 。 

play a souy\d *bV^c 
ay\sv/cv- is 乙七 … 


… 如 d 3^o*thc\r -Pu^dtio^ 

"to play d sou^d when the 

a^swc\r is y/v-o^g. 


TVic ^U| pv-oyam still 
一 r\ccds *to use fY^amc- 




correct_s = sounds.Sound("correct.wav") 
wrong_s = sounds.Sound("wrong.wav") 

prompt = "Press 1 for Correct, 2 for Wrong, or 0 to Quit : 



You still r\ccd "to rna'mtam 
•t^ese tountev-s. 
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choice = input(prompt) 
while choice != 'O': 
if choice — '1 1 : 


number ^ 


—numbe—n—ja—s 上 —ed + 1 

number correct + 1 
一 

： ct_s . play ( 


number 


correct 


finish (correct s 


if choice 


*tWiS to&t 
lay 一 代乙七一 sowr ^() 


2 


number asked = number asked 

number_wrong = number—wrong 
z^it_finish(wrong_s.play()) 
choice = inpuIT (plump L) - 



Tu^ this codt ihio ihc 

r a y- w ' r ^9L_souhdO w 

-ruh^-tioh. 


print ("You asked n + str (number_asked) +_ " np^ 

print (str (number correct) + ’▼ were correctly answered.’▼) 


print(str(number wrong) 


were answered incorrectly. n ) 


l^- pisflay'mj 

summary \rcmams d 
"too- 


With the code you need identified, you were to take the time 
to update your GUI application with the new functions and 
whatever other code you’ve extracted from the non-GUI 
program. 

You were asked to produce a new program that is a 
combination of your existing GUI code and the extracted 
code from this program. 


the page S^ OY 
updated code solu-tioh... 
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button press rehearsal 


The frUl program's wow ready for 
a scrcGwtcst 

Here’s what your GUI program should look like now: 


from tkinter import 


女 


import pygame.mixer 

sounds = pygame.mixer 
sounds.init() 


correct_s 
wrong s 


sounds.Sound("correct.wav") 
sounds.Sound("wrong.wav") 


number_correct = 0 
number wrong = 0 


def play_correct_sound() : 
global number—correct 
Pyt^o^s 'global number—correct = number—correct 

correct s.play() 


keyv/ovd lc*U 
you adjust *bV^c 
value associated 
a variable ' 
heated ou*tsidc 


The buttems how 

^ceied io CVCht-. 


def play—wrong—sound(): 
global number_wrong 
number—wrong = number—wrong 
wrong_s.play() 

app = Tk() 

app.title("TVN Game Show") 
app.geometry('300x100+200+100') 

bl = Button (app, text = "Correct!’，，width = 10, command 
bl.pack(side = 'left', padx = 10, pady = 10) 


play\correct sound) 


b2 = Button (app, text = "Wrong !，，， width = 10, command 
b2.pack(side = 'right', padx = 10, pady = 10) 

app.mainloop() 

print(str(number—correct) + " were correctly answered. n ) 
print(str(number wrong) + " were answered incorrectly.") 


play wrong sound) 
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Tesr DriVq 


With the code you need extracted from the nongraphical application and 
added to your GUI program, press F5 in IDLE to see (and hear) if things are 
working any better now: 






I 七 y\o 七 1°°^ 
^ood) W 七 y\o>w 


Splat! 一 


Every time you click on a button, the appropriate sound 
effect is heard. Great work! 


tWeiare no o 

Dumb Questions 


So “event handlers" in tkinter are just functions? 

Yes, as we said earlier in this chapter: ifs all just code. And 
by putting the code you want to run in a function, it's easy to 
reference it using the command parameter associated with each 
button. Your user clicks the button to run the code in your function. 

This actually isn't too hard. I always thought building a 
GUI was only for advanced programmers? 

Well... that certainly used to be the case, but things have 
changed (for the better). Technologies like tkinter allow every 
programmer to build great-looking GUIs without too much fuss. It's 
a case of tkinter concentrating on the GUI, while you concentrate 
on your code. 


And is it the case that, if I want to add other things to my 
GUI program, it’s done in a similar way? 

Yes, all you have to do is write the code. 

And I connect my code up to my other things using 
something like the command parameter that works with 
buttons? 

Yes, that’s all there is to it. The mechanism for the other 
interface elements (or widgets, for short) might be a little different, 
but the concept is the same. Once you can work with one, the rest 
are a lot easier to get your head around. 
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missing results 


Put TVN is still wot happy 


The sounds work great, 
the GUI looks fantastic... 
but where are my results? 
I caiVt find them! 


The results appeared in the Python Shell, 
not in the GUI, so the host missed seeing 
them. When you point this out to him, he’s 
less than impressed and makes it clear that 
he expects the results to appear in the GUI. 

You need some way to display 
messages in the GUI. 



TV>C \rCSul*U 3V-C 

\ r 吵七 

pY 七 ho 扒 Shell. 七 

-tWis \s NOT 
七 V^os*b 
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The interface elements that you add to a GUI are known as widgets. 
You’ve met one already: the button. There are lots of others. Look at 
the names of some other widgets below and see if you can match them 
with the correct description. We’ve already done the first one for you. 



A widget that provides a way for large and 
small amounts of text to be entered 


A separate window that pops up to request 
additional information from the user 


A widget that displays a string message in 
a window 


The combination of a drop-down list and 
a text box 


A widget that allows you to select one item 
from a large list 


Dialog box 


A list of command options that is attached 
to the top of a window 


七 c y ouv 


Which widget do you think you need to use in your program? 


ay\sy/cv- V^cv-c. 
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label it 




The interface elements that you add to a GUI are known as widgets. 
You’ve met one already: the button. There are lots of others. You were 
to look at the names of some other widgets below and see if you could 
match them with the correct description. 


Drop down list 


Lctbel 


Text box 


Menu 


Combo box 


Dialog box 



A widget that provides a way for large and 
small amounts of text to be entered 


A separate window that pops up to request 
additional information from the user 


今 A widget that displays a string message in 
a window 


The combination of a drop-down list and 
a text box 


A widget that allows you to select one item 
from a large list 


A list of command options that is attached 
to the top of a window 


You were asked to identify which widget you would use in your program. 

Use -the “Label” y/idyt. 

y ou b> add a label -to your ^U| m 
order -to display results. 


248 Chapter 7 









building a graphical user interface 


Label it 


When it comes to adding a label to your GUI, use the tkinter Label widget. 
You create it in code not unlike the way you create a button. Here’s the code 
to add a label to an existing GUI application. The label simply displays a 
string: 


Cvcatc a label，attaA 

{p md'm WmdoY/, yve 
•i 七 sowC 七 c 此 adjust i\\t 

/ label’s V^Wb. 

V- 


= Label(app, text= 1 When you are ready, click on the buttons! *, height = 3) 
.pack() 


Doh’t -fovget io padkO the Widget 



Put label todt fecW 
七 todc -fov- Wtto ⑽ 
扣 d 払 c 6WM 1 七 ^ look 
like tWis. 


Another variation replaces the text parameter with textvariable. If 
you assign a special tkinter variable to this parameter, the label will change 
whenever the value of the variable changes, automatically: 


c — % 


Asso^ic 一 

the 

with ihc 
label. 


num_good = 工 ntVar() 
num good.set(0) 


11 = Label(app, textvariable = num_good) 
11.pack(side = 'left') 


num good•set(100) 




updates, as i-f by 
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add labels 



j£an 莒 ExeRdSe 


Based on what you now know about adding a label to a GUI, 
rework your GUI code so that it uses two labels. One should 
display the number of correct answers and the other should 
display the number of wrong answers. We’ve left plenty of room 
for you to write in all the code that your program now needs. 
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label results 


ExGRdSe 


Based on what you now know about adding a label to a GUI, you 
were asked to rework your GUI code so that it uses two labels. 
One should display the number of correct answers and the other 
should display the number of wrong answers. We left plenty 
of room for you to write in all the code that your program now 
needs. 


libv-avy Codt you need. ) 


Cvcatc the two 
cvcht kahdlev's 
that set the 一 


|ht\/a\r a^d play 

the appropriate 


souhd. 



dc-f play (-oYYtcA, souhdO: 

• ••••••!••• . . . . . . 


hum aood sc*t^um (\ood (\C*tO + I) 

. __ J ••••••.. .•••• ••參 ••籲•拳争 

dovredt—s.playO 


dc-f play wrohOi souhdO ： 

I .!• • • • , • • • • • • . . . ... 

ywavv\ bad.se 七 (hum bad <\e*tO + I) 

.... •••••• •籲參 •••••• _ ■ ， ••••參<^1 .. • 


wrohj^s.playO 


...../ app^TkO . 

Create m ^ ^ app.t, 七 lerW/^aw Sh ⑽”） 

apfli 乙 a 七 K) 於 y/mdov/. . . . . . '- 1 . 


l^itializjC the 
souhd system. 
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Losd ih "the 
\rc^ui\rcd souhd 

dts. 

Ortait W 
l^-bVavs ： OY\t -to 

to^i 朽 ， bev 

o^f torrtd av^evs 
and a^o-bV^cv -to 
6 娜七七 ^ v^umbev 7 ^ 

V/VOV^ av\SViCVS. 


toYYtt{, s =■ souhds.Souhd^ U do\r\rcd*t w3v ，； ) 


^roY\^_s 二 souhds.£our\d( u y/\ror\j y/av ， 0 


hum^ood 二 |h*t\/9V"0 


hum_jjoodse*t(0) 


hum bad ― |h*t\/av -0 


jr\um bad.se*t(0) 


Display a -P\ric^dly ^ . 

f" s 七 ^ lab =■ LabcKapp, -tcx-t—Whch you arc ready, dlidk oy \ -the bu*t*toy\s| ; , he— 七二 3) 

Be su^e {o ?m your ^ ㈣ a ， k .° . 

v/id^cis. 


Cv-ca*tc *two 

labels -to hold 
CBCM dou^*tc\r / 
d^d Co^titC^ "the 
labels -fco the 
v-dcva^*t l^*t\/av-s. 


labl — LabeKapp, *tc%*tvariablc =■ … 州一 y>od) 

lablfadk(sidc =■ U*t ’） 



labZ =■ LabeKa^p, *tc%*tvav-iablc =■ num—bad) 
labZpadk(sidc =■ Vi—t ’） 


bl 二 Bu*t*bor\(a^, ― ^Corv'cd!^, width 二 IO, Command 二 dovre^t 一 souhd) 

Suwsall ^ b, ：.f a .^ (si<le ..- . ! le ^/. . ? a .^.! 9> .?^Y..- . !91 . 

tor\y\Ct*b -tV^cm *to 

{\\t\r \rclcvan*t . 

eveyrt iiair\dlcv-. >v bZ 二 Bu*t*toh(a 作七以七二 'Wror^"’, wid 七 h 二 10, 二 J>lay__y/\ror\c^__souhdi) 

bZ.padk(side 二 Vif^lrt’ ， pad% =■ 10, pady =■ 10) 

S-tavt . 

tkih-tc\r s maih 

evcht loop. . .. ,、 

app.mamioopu 
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test drive 




Tost DriVq 


With your newly amended code entered into IDLE, press F5 to see and 
hear the GUI in all its glory: 


Swcci... -the -fully wov-k'mg 6\\A\. 



TVN Game Show 


When you are ready, click on the buttons! 



16 


“I dedisioh ： who 
9 oih 9 to iake with you? 
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^ — labels art 如 ㈣ 叫 
\rurmi 吒 Vtals 
mouse c]\ck (CV ⑼七 ). 


Tiicv-c i*t is ： V^os*ts 
wnrmnr^ TV srtnilcf 














building a graphical user interface 



Your Programming Toolbox 

You’ve got Chapter 7 under your 
belt. Let’s look back at what 
you’ve learned in this chapter: 




Pythoh lols 

* - a p^cssiohal-lcvcl sci of 

9 amih 9 supped souhd 

* pass - , p ic , c ^ , odc iu docs hothihj 

* - cxii a loop 

* 仕 … 七饮 - a shhd 扣 d lib^vv ^ 

⑽ _ y 

^ TkO - a blahk ^U/ app 

* 队 H a tkih-tcv bu-t-toh widget 

* kbdO - a -tkih-tcv label wid^ei 

f L 巧 ' / a “) - a tkihtcv ihtegeir viable 

七咏 w update -the ^Ul u as i-f by 


CHAPTER 7 
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8 gms and data 


本 Data entry widgets ♦ 



GUIs don’t just process events. They also handle data. 

Almost all GUI applications need to read user data, and choosing the right widgets can 
change your interface from data entry hell to user heaven. Widgets can accept plain 
text, or just present a menu of options. There are lots of different widgets out there, which 
means there are lots of choices, too. And, of course, making the right choice can make all 
the difference. It’s time to take your GUI program to the next level. 


this is a new chapter 
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special delivery 


Head - Ex needs a new delivery system 

Head-Ex Deliveries is a small delivery company that’s looking to expand. 
They know that delivery companies rely on their computer systems, so they 
want to have a whole new system to book deliveries around the country. 



The system needs to be simple to use, so they want to use a graphical user 
interface (GUI). They want to give you the job of creating the system and 
even have a sweetener to make it worth your while. 
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guis and data 


ThcyVc already designed the interface 

Head-Ex has been thinking about expanding their business for a 
while and they already have a design for the interface to the new 
delivery system. This is what it needs to look like: 


Depot: 


t<^ 


Descrip 七 ion 


TV^cvc avc a 
Jr da-ta-cv'-tvV 
-fields- 


k a 



This is whc\rc the 
delivery de-tails 
y\ttd -fco be saved- 


So how will it work? It’s pretty simple, actually. The user enters the 
details for a new delivery, including the description of the contents, 
the address it’s heading to, and the name of the Head-Ex depot it 
will be dispatched from. When the user clicks the Save button, the 
details are saved into a file called deliveries . txt. 


deliveries.txt 





What’s the difference between this GUI and the ones you created before? 
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text entry 


Read data from the frUl 


Think about the GUIs you’ve created so far. Those apps ran code in response 
to events generated by users clicking buttons. So what’s different here? Well, in 
addition to generating events, your users will also be creating data. 

You need to do two things: 


O You need to create an interface with places to enter text 

The Head-Ex design shows exactly what the interface will need to look 
like: 


Depot: 



❺ You need some way of accessing that information. 

The data will need to be stored away in a file, so you need some way of 
asking the interface what text has been entered. That way, when 
someone clicks on the Save button, you’ll be able to write the data to 
the deliveries . txt file, like this: 


/ou will Y\tt& -to APPEND -this 
*m-Po\rinf»aiio^ -to ihc -file 
sorwcor^c pv-csscs “Save." 

The -fovma-t ^ 

docs^-t mafe as lo^ as 
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guis and data 


The Ewtrv and Text widgets let you ewter 
text data iwto your ftUl 

If you look at the interface design, you’ll see that there are two different types 
of text field you will need to handle: short text and longer, multi-line text 
fields. To deal with these two needs, Python’s tkinter library has two different 
widgets for each data-entry type: 


TtyJ FIELP is just a 
IT 7 ou 

use *to cv\*tcv* *bd 


Entry widget: for entering single lines of text 

The Entry widget is what you’ll use for most of the text fields. You can 
create an Entry widget like this: 


伙 a 七 

aUay wed 仫 
七 kmW I'.WayrV Wst 


small field = Entry(app) 


0 伙 o( icxi 


tarbya:zceo§gmail, com 

7/////////M 




Text widget: for longer, multi-line text 


Because not all text data fits on a single line, tkinter has the Text widget. 
Think of email messages, Wikipedia pages, and word processing documents. 
For large multi-line data, you need something other than Entry. You need 
Text: 


Multiple lihes o-f text 

\L 


my large field = Text(app) 


You Uy\ la^ry ficdcs o( 

*tc%*tual data *m V>cv-c- 




Costellti : X ioea.n the fallow 1 -s name . Abboibt : Who 
Costello : The qiay on first a Abbott: Who^ Cost&l- 
Ilo: Th* iisst Abbott: Who ， Cost*llo: Th* 

gyy playing... Abbott: Who is on first! Costallo; 
1*111 asking YOU who 1 b on first, Abbo11 1 That 1 3 the 
man H 9 name. Costilla : That 1 ^ who r s nama? Abbott" 
Yes. CosW&ll qc ahaad and ball 100 , Abbott 
TKat 1 b it,. Costello : That 1 b who? Abbott.: Yes. 




The Entry and Text fields should be enough to create the Head-Ex 
interface. But it’s not enough to simply create the interface. You also need to 
control the data inside it. 
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control text fields 


Read and write data to text fields 

When someone enters text into an Entry widget, Python stores that text 
somewhere in memory as a string. If you want to read the string, simply call 
the widget’s get () method: 


my entry field.get() 


w 个 w 

This will V"C*tuv*r> "the w i£.c 



But what if you want to change the contents of the widget, can you do that 
too? Yes, you can: add text to the widget using the insert () method. It’s a 
little more involved than just reading the text, because you need to say where 
you want the text inserted: 




entry 一 field•insert( 0 , "banana ") 

TV^C*>s i\\t |KPt>< ^ 

七 he 'mscv*b'«o^ ㈣ 灼七 • 




jjf 


banana ice cream 



o I 午 ^ 



^v\b-y f ields 


av-c 


mdc^cd -fv-ow 0. 


You need to specify the index of the insertion point. Indexes in Entry fields 
work just like indexes in strings: they begin at zero. So if you insert text at index 
0, the new text will appear at the front of all the text already in the field. In the 
same way, the delete () method lets you remove text from the field. You 
might want to delete the entire contents of the field, so tkinter gives you a 
handy END symbol that lets you delete all the text like this: 

0 is i\\t mdex. 奶七 

This y/ill delete tk ch-tivc m ^\d 

my entry field.delete(0, END) 

'' >T 

END is a special value 
that \rcp\rcschts the last 
ih the -field- 


TV -f'mal t\\aracit\ 
m -f ield ,s 
mdwd I 07 


.■ 







All "the Kds 0ohc. 


The get (), insert (), and delete () methods give you complete 
control over the contents of your Entry field. 


But what about Text fields? 
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guis and data 


Large Text fields are harder to handle 


So Text fields should work the same way, right? Well, actually, they don’t. 
The designers of tkinter figured people might want to access particular lines 
and columns in Text fields. This means that while Entry fields use a single 
number to index the contents of the field, Text fields use a string, in the form 


row. column: 


Uhlikc 
3 祍 


B ^y° fields, you 

t j us ^ use 9 ctO 

仏 e Ch-timc 


^Oh-tch-ts. ^ 

my 一 large 一 field • get ("1.0 

'' r 

TW»S vcWv' ❹七’代 

o-f M 


S^Wsi dV^avadtcv- rn 


END) 

(This 


will \rc-tuv-h 

All o-P -tex-t 

-the Tcx-t -field. 


T/k “ s 七 has i h dcx u /.O w 

Row I. 



fltelLQ r I raesn 



he Eellow 1 * nmma . Abbott; ? Mho. 

Th* 穿 uy Rl=J □ 口 .tt: Hho. • 良 ■ 

10 i *the first basantan . Abbott: Sflio „ CDatMilo ; the 

guy playing , r , Ahtiejtt = Hho xjj 口 n Cp*tnll!^: 

1 1 d aaki.ng YOD whs 1 « on first. Abbatt i That 1 a the- 
■HkTi d 0 naim . Costello; That* s who" b n«ma? hbbo-tt ; 

Yas ■ C^>si to-llo: Eltkll ga a.ho3.d And tail mo, ABbc-t t : 

士 hat's JLt.. CoBteLla: That ¥ b who? Abbott: Yes. 


w ： 


Column 0- 


Once you understand how Text indexes work, you’ll see that you can insert 
and delete text from them in a very similar way to Entry fields: 


my large field.delete( n 1.0", END) 

_ _ A 

丁 his will dlca\r the -field- 


my_large_field.insert("1.0", "Some text") 

"" T 


Now that you know how to create text fields and 
control the text they contain, you’re ready to 
build the Head-Ex application. 


: 心 ㈣ 



Be careful how 
you number 
rows and 
columns in 
Text () fields. 


Rows begin at 1 ， but columns 
begin at 0. 
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create the interface 



Code Magnets 

Complete the code to create the interface. Think carefully about the 
widgets you will need for each of the fields. 


from tkinter import 


产 do^i hccd 

2 ° br^t\c of 


Cv*ca*tc ^W|- 


app = Tk () 
app.title('Head-Ex Deliveries') 


s o ho 


thcni ^ tables. 


^ R^all Vf 工 

Label (app, text = "Depot : . pack () ^ 


depot = Entry (app) ^y ou1 | _七 铋 k 叫 ^ 
depot • pack () o-P the data e 士 y -fields, so 


therw {jo vd\ridbles. 


Call'mg 、把以广 Without options 
you leave *rt *to *tk*m*tcv 
*bo decide Kow best *to lay 

*t)Vl 呼 OU*t OY\ ■tKc 6\Ul 


Button(app, text 



Save ’，， command = save data) .pack () 


TWis mca^s i\\c W 七 W 
Will tall *b^c save 一 da*ta() 
-fuy\ttioy\ rt’ s tUcd. 
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guis and data 


厂 %^rpen your pencil_ 

Jr In addition to the GUI code, you need to write the function that 

will save the data from the GUI to the deliveries . txt file. 

The Save button on the interface is going to call a function called save_data () .The function will 
append the data from the GUI to the end of the deliveries . txt file formatted like this: 



Depot : 
Seattle, WA 
Description : 
Books 
Address : 

1 Main Street 

Anytown 

WA 


Then it will need to clear the fields on the form to make them ready for the next record to be entered. 
The function will have to appear in the program before the GUI code. Write the code for the function 

pi" wa 

y^ccds save data . 、 

THEN «七 -to t'cav . 
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interface created 



Code Magnets Solution 

You were to complete the code to create the interface. You were to 
think carefully about the widgets you will need for each of the fields. 


from tkinter import * 






app = Tk() 

app.title('Head-Ex Deliveries') 
Label (app, text = "Depot:") •pack() 
depot = Entry(app) 
depot.pack() 


^ ii 


Cvcatc two 

-fields ： oy\C is 

ah Bv\bry -field 
3hd the othev- 
is a Tc%i -field. 




Tt%i 




Label(app, text 

="Description:") | 

packQ ] 

description = 


1 Entry(app )1 

description 

.pack() | 

Label (app, text = "Address:") | (Tpack M ] 

^r- _ 





1 address = 1 

Text(app) 




Doh’t -Po\rgct -to padk 
those widgets. 



I.pack() 


Button (app, text = "Save" ，- command = save—data) .pack () 
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guis and data 


^Sharpen your pencil 


V Solution 


The Save button on the interface is going to call a function called 
save_data () .The function will append the data from the GUI 
to the end of the deliveries . txt file formatted like this: 



Then it will need to clear the fields on the form ready for the next record to be entered. The function will 
have to appear in the program before the GUI code. You were to write the code for the function here: 

^ d cr maY , l00k 3 铋如 ⑼ d 

Irbtlc d 似 ⑽ t \ as you did wc wrote POS 

-filcD =■ o 产 h( l 'delWeries.*bct''V ’） 

^io 代 w 如 .. 

\Z\A^ ^ ^ U{ySI 一 

i 1 eD. W 〒 *tio)rAh ”） 

-filcP.w\ri*tc^ W %s\h W % dcsd\rip*tioh ^C*tO) 

^,leD.write( w Aaaress ： V) 

VCW^S tnc — . . . .... 

j 。 古山 乂 a Tc%i 二 ^lep ： writer%s\^ 》 .O' END)) 

dcpo-t-ddctc^O, END) 

M h> dlea, . 

^ 3 ^ eir sav ^9 \9ddress.deleieC l l 0 ,} , END) 

TK'is medy>s w ls*t yo^j, 0*tV> dolumw Rcmcrwbcv' 
vo>ws s*tcl\rt 3*t I a^d dolumy>s -fvom 0. 
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test drive 




Tost DriVq 


The deliveries program is ready, so it is time for the demo. With the code 
entered into IDLE, press F5 to fire it up and you should see this: 


^ u,r ^Ul is 

loo ^3 3ood. 



You can enter data into each of the fields, even the multi- 
line address. When you click Save, the fields all get cleared. 
When you open up the deliveries . txt file, you see that 
the data you entered into the GUI has been saved. 


Depot : 

Seattle A WA 
Description : 
Books 
Address : 

1 Main Street 
Anytown 


Congratulations! You’ve written your 
first GUI data-entry application. 
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guis and data 


BULLET POINTS - 

■ Entry fields are used for single lines 
of text. 

■ Text fields are used to handle multi- 
line text. 


■ Remove text with the delete () 
method. 

■ Entry fields are indexed with a 
number starting at 0. 

■ Text fields are indexed with a string, 
starting at “1.0”. 


■ Read the contents of fields with the 
get () method. 

■ Add text using the insert () method. 


tWeiare no o 

Dumb Questions 


Is it possible to put more than one line of text into an 
Entry box widget? 

Yes, you probably could, but if you need to do this, you are 
much better off using a Text box, because they are designed to 
handle more than one line of text. 

I notice that we are calling the pack() method as part of 
the label creation code, whereas before we assigned the label 
to a variable then called pack() on the new variable. Which 
packing technique should I use and does it really matter? 

No, it does not really matter which technique you use to call 
pack (). If it makes sense to pack your widgets as they are 
created, include the call to pack () as part of the creation code. 
If it doesn’t make sense, assign the widget to a variable and do 
your packing whenever you need to. If you look at other examples 
of tkinter code on the Web, you'll see that other programmers use 
both techniques. 


Why can’t we just assign a value to an Entry box using 
the assignment operator (=)? Why do we have to use the 
insert() method? 

The Entry box is a widget object, not a Python variable, 
so using the assignment operator does not make sense here. 
When working with objects, you need to use the application 
programming interface (API) provided by and included with the 
object, which in this case is the insert () method. 

Why do the rows in a Text box start counting from one 
as opposed to zero (like everything else in Python)? 

Beats the hell out of us. No idea. 

So, just to be clear, Who is on first? 

No. Who is on second. Python is on first. 
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the other Cambridge 


Owe of the Head-Ex deliveries wewt astray 


For the first few days, the system worked great. Deliveries were correctly 
booked and goods were shipped. But then, something odd happened at the 
British delivery depot. 



One of the deliveries went seriously astray. A consignment of college 
football jerseys was sent to Cambridge in England, instead of the Cambridge 
in Massachusetts. But the system is still working fine, isn’t it? So what could 
possibly have gone wrong? 


rm terribly sorry, old chap, 
but I think these boxes 
were meant for the other 
Cambridge. Cup of tea? 


There’s no time for tea. Let’s get to the bottom of this. 

But i*t wds lovely 

"to be asked... 
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guis and data 


Users caw cwtcr awythmg m the fields 

The system is doing exactly what it was designed to do: it lets people enter 
the details for depots, descriptions, and addresses. The trouble is, even though 
there are only a few depots, the Entry text fields lets the user type pretty 
much anything. There are no controls on what gets entered into the GUI. 



This is Mdl6iU0U^ H 
•_s -totally dear whi 乩 

Cambridge is mcaht 


It wasn’t obvious whether the delivery was intended for the Head-Ex depot 
in Cambridge, MA, or the Head-Ex depot in Cambridge, England. You need 
some way to prevent users from entering ambiguous data in the depot field. 





Think about the GUIs you’ve used in the past. How could you 
restrict the values that someone could enter into a GUI? 
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radio ibt/ 汁 ons 


Radio buttons force users to choose a 
valid depot 

Text fields aren’t the only data-entry game in town. If you look at any 
GUI program, you will find a whole host of different widgets being used: 
sliders, buttons, check boxes. Why are there so many different types of 
widget? Are they just there to make the interface more interesting to use? 

The reason there are so many widgets is to allow the programmer to 
efficiently manage and control the kind of data that people can enter. 


Cl'itk 


_ and 七 UM WtW。? 


s \A^ 



If you want to allow a small number of values for a field, you can 
use the radio button widget. A radio button works just like the AM/FM 
selection buttons on your radio: press AM and the FM button pops up. 
Press FM and the reverse happens. 

Radio buttons in a GUI program work in the same way: if you select 
one of the buttons, the other buttons are automatically deselected. That 
way, you can choose only one from a small group of options. 


R a d、o WtW 


Depot: 



CS> Cambridae ； 

O Carobridae ； U \4 
O Sea-ti\e ; uoA 


Cli^k F/V) 3hd the AA1 but-fcoh Pops uP. 

\ 



Descrip-tion ： 



] 



So if you replace the depot Entry field in the Head-Ex 
program with a set of radio buttons, you prevent users from 
entering ambiguous depot names. That way, they will be able 
to choose one, and only one, depot. 
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Sounds OK. 
Can I see a 
prototype? 




































guis and data 


Creating radio buttons m tkiwtcr 

You need to create three radio buttons in the interface, one for each of the 
depots. This is how you might do that in tkinter: 


)U Aor^i 

^T 0>rt ' 


Label(app, text 
U. '"Fi'n (. 


Depot : • pack () 


Radiobutton(app, text = n Cambridge, MA").pack() 
Radiobutton(app, text = "Cambridge, UK").pack() 
Radiobutton (app, text = ’’Seattle, WA") .pack () 

Label (app, text = "Description:")•pack() 


^ is is "the -tex-t 

七 will app 分 

h> -the iradio 
bu't'coh. 


You need to remove the depot Entry widget and replace it with three 
Radiobutton widgets, one for each of the valid depots. The text given to 
each widget will be the text that appears alongside the radio button in the 
interface. 

What about reading which radio button has been selected? For now, you just 
need to create a prototype of the interface, so there’s no need to change any 
of the code that saves records. That’s something we can deal with later. 

Let’s demo the new interface to the guys at Head-Ex. 


you are here ► 


273 
















test drive 




Tesr DriVq 


It’s time for the demo of the new version of the interface. When the guys 
from Head-Ex arrive, you fire up the new program in IDLE: 



There’s clearly something wrong with the prototype. There is only 
supposed to be one radio button selected at any one time, and yet the 
program shows all of the radio buttons selected together. 


What happened? You need to look in a little more 
detail at how radio buttons actually work. 
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guis and data 


The radio buttons should work together 

When you modified the code, you added the three radio buttons like this: 

Radiobutton (app, text = ’'Cambridge, MA" ) .pack () 
Radiobutton (app, text = ’’Cambridge, UK" ) .pack () 
Radiobutton(app, text = "Seattle, WA").pack() 


That code added three new radio buttons to the interface, but it created 
them as three independent widgets. This means that each of the radio buttons is 
working separately, with no knowledge of the other two. 



CamlDridge, MA 

0 幻 Cambridge, UK 
Seattle) WA 


But the whole point of radio buttons is that they work together. 
When you select one radio button, you expect all of the other radio 
buttons to be deselected, just like the buttons on the radio. 

GUI programs often need to synchronize different widgets 
together. You do something to one widget, which results in 
something else happening to another widget. 

So how might you get your radio buttons to 
cooperate? 



W\\cy\ tVic AM button is 
selected, FM Wtto” 
should be dcsclct-bcd- 





Think about the way you want radio buttons to work. Is there something 
that they all need to share? What is it? 
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model update 


The radio buttons can share a model 


The text fields you originally created each stored a single data item. For every 
widget on the screen, there was a single piece of data. But that’s not true 
for your radio buttons. The three radio buttons will be used by the user to 
record just one thing: the depot that a delivery is sent to. The three radio 
buttons needs to share a single piece of data. And that piece of data is called the 
model. 

ril keep my eye on 
the model until I*m 


clicked... 


0 


TW»s is i\\t wodcl 


Q) Cambridge, MA 



Click me, so I can 
update the model.. 


[can" 

lodd … y 


(0 Cambridge, UK 


^Seattle, WA 


So if the Seattle radio button is selected, it will update the model with 
a new value. 


You haven’t set values on the radio buttons yet; you’ve only set text 
descriptions. You could set the values to be whatever you want, but it is 
simplest to set them to the same thing used as the description of the field: 


丁 he text is "the dcsd\rip"tioh 
七 hat appeals oh the sdv-cch. 




RadioButton (app, text 


TW»s VAUUt 
Will be used m 

"Cambridge A MA n , value = ’ 'Cambridge, MA n ) 

You cav\ w>akc i\\t di 

-(■y*ow> vsluC) bu*t lc"t s 

^CV"C- 


So what happens after the model is updated? 
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guis and data 


The system tells the other widgets whew 
the model changes 


The tkinter library code will keep a track of which widgets are using which 
models and, whenever a model changes, tkinter will let the widgets know 
about it. So if we select the Seattle, WA radio button, it will update 
the model, and the other radio buttons that share the model will deselect 
themselves. 




CamlDPidge, MA° 



t«) Seattle, WA 


Well, thafs not my 
value, so I'd better 
deselect myself. 



There’s a special name for the way this code works: 





Model 

厂 , 


View Controller 





The model is the data stored. 


The view is just a fancy name for the widget. 


And the controller is the code in tkinter that lets all of the views know 
when the model has changed. 


So much for the MVC theory. Time to fix the code. 
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tkin ter models 


So how do you use jyiodels m tkiwtcr? 

Imagine you wanted to add delivery options to the program. You could use 

radio buttons and do something like this: | 七 ， s 七 *to ^)<PL|C|TLy Jive 

cadii Wtton a VALUE- 

Radiobutton(app, text = "First Class", value = "First Class").pack() 

Radiobutton(app, text = "Next Business Day ", value = "Next Business Day").pack() 


You then need to create a model for the radio buttons to share. In tkinter, 
models are called control variables, and control variables that store text 

are called StrinqVars: , ,, .. . , x/ r 

A Stv-*m 5 \/av- »S just l.kc kwar W 

\i V^olds a sVmj vak. 

service = StringVar() ^ ^ ^ / 狄托忪 special value 

service, set (None —⑽ y o va | uc .” 

Radiobutton(app, text = "First Class", value = "First Class", 

variable = service).pack() 

Radiobutton(app, text = "Next Business Day n , value = "Next Business Day' 

variable = service).pack() 


This code will now give us a pair of buttons that work together. If you 
select one, the other will automatically become deselected: 


Clitk the StCOKP option ar.d FlPSt CiSSS 
如服订義 —. Busmess Day 


And if you ever need to read or change the model value in the code, you just 
need to call the StringVar’s get () or set () methods: 

. _TWis v-cW^s i\\c 

»> print (service .get ⑴ ^ ^ ^ ^ 

"Next Business Day" 


»> service. set ("First Class 


T^l S f h J hc -odcl obje^-t 

/f \ ^ C,ass " will 

，卜士 ||y 韻忪 〜七 

ad, ° bu -t-toh Oh ihc s ⑽ Ch . 


Q First Class 

Next Business Day 
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guis and data 


Paa] Plizzjc 

This is the section of the program that 
creates the depot radio buttons. See 
if you can complete it using the 
fragments of code from the pool. 
Be warned: you might not need 
all of the pieces... 


Label (app, text = "Depot:") •pack() 



depot.set(None) 

Radiobutton (app, . , ,. ) . pack () 

Radiobutton(app, .,. ,. ).pack() 

Radiobutton(app, . , , ) . pack() 


Note: each thing from 



Sharpen your pencil 


What piece of code would you use to make sure all of the radio 
buttons are cleared offer the record is saved? 
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depot buttons 


Paa] puzzjc 

This is the section of the program that 
creates the depot radio buttons. 

You were asked to see if you could 
complete it using the fragments of 
code from the pool. Not all of the 
pieces were needed. 


Label(app, text = "Depot : n )•pack() 

depot = StringVar() 

depot.set(None) 

Radiobutton(app, variable = depot, text = "Cambridge, MA" , value = "Cambridge, MA M ). pack () 

Radiobutton(app, variable = depot, text = "Cambridge, UK" , value = "Cambridge, UK"). pack() 

Radiobutton(app, variable = depot, text = "Seattle, WA n , value = "Seattle, WA n ). pack () 



Note: each thing from 
the pool can be used 
only once! 




o-f vacTio — 
buttes Viavc *tW»s value, v\ov\t 
o-f Vill be sclcd*tcd- 


What piece of code would you use to make sure all of the radio 
buttons are cleared after the record is saved? 

▲ dcpo*t-srtWohc) 


280 Chapter 8 


























guis and data 



Tesr DriVq 


Now it’s time for another demo of your program. When you first fire up the 
program, you see that there are initially no depots selected. 



That’s good. Now what happens if you select the first option, then change to 
the third? 



El 




l>cpot: 

卜 r?i ： mhriri-gp. MA 
Cambridge UK 

f 謙 




H«ad-Ex DflllVWlifrE 


Oepot: 

Cambridge, MA 
Cambridge-. UK 

■- 5 叫 LlhWA 

Description ： 


|-f you sclent w Sca*b*blc, 
you ly 

deselect u Caw\b\r*id5c> 

MA". 





If you make a selection, the other radio buttons automatically deselect 
themselves, which is exactly what you need. 


The radio buttons are working correctly. 



Phew. Now the users will 
always send the packages 
to real depots. You did a 
great job. Thanks! 
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many more depots 


Head-Ex's business is expanding 

With the new systems in place, business is better than ever at Head-Ex. They 
have new trucks, more employees, and an increasing number of offices. 





is dcfo*b 


all ovcv *tV>c >wovld. 


But with this success comes a new problem... 
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guis and data 


There arc too many depots on the WJI 

The coders at Head-Ex have been amending your program to add new 
depots as they were opened. But there’s a problem. Now there are so many 
depots that they can’t all fit on the screen. 


㈣ ead-Ex Deliveries 



Something needs to be done to the GUI. But what? 





What kind of widget would you use instead of a radio button to fix this? 
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multiple options 


An OptiowMcwu lets you have as many 
options as needed 

An OptionMenu or drop-down listbox is a widget that lets you restrict the 
number of options a user can choose, just like a group of radio buttons. But 
it has a couple of important differences. 


First, it takes up a lot less space than a functionally equivalent group of radio 
buttons, about the same amount of space as an Entry text field. Second — 
and this is the really important characteristic — when you click it, an option 
menu can display a large list of options. 



Depot: 

Cm? A 

iCaiyibridge, UK 
|SeaJt ， u la h WA 
New YoPk, NT 
[Dallas, TX 
boston, MA 
•iRonie, Italy - 

Male, Maldives 
Luxor, Egypt 1 

Rhodes, 

Edinbur^h^ Bcot^and 


：-3 



"The usc\r Could 
sclcdi a depot f\ro^ 
optioh ry»Chu. 


F=J 




If the Head-Ex coders use an option menu, they will be able to increase 
the number of depots available, but they won’t have to increase the size or 
complexity of their GUI. 

So what needs to be changed in the code if you want to swap the radio 
buttons for an option menu? 

It’s not what changes, but what stays the same. 
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guis and data 


The jtiodd stays the same 

Think for a moment about the model you are using with the radio buttons. 
It represents the name of the chosen depot, which you want to keep for the 
option menu. If the model stays the same, then your code, which currently 
looks like this: 


depot = StringVar() 
depot.set(None) 

Radiobutton(app, 

Radiobutton(app, 

Radiobutton(app, 

can be replaced with code like this: 

depot = StringVar() 
depot.set(None) 
OptionMenu(app, depot. 


variable 

=depot. 

text — 

’ 'Cambridge, MA ", 

value — 

'▼Cambridge, 

MA").pack() 

variable 

=depot. 

text ― 

’ 'Cambridge, UK ", 

value — 

'▼Cambridge, 

UK").pack() 

variable 

— depot. 

text = 

"Seattle, WA", 

value — 

’ 'Seattle, WA M ) .pack() 



Cambridge, MA' 


’Cambridge, UK' 


TV,e 州哼 

model a^d 

wed 从 c 二 brt. 


A list o-p all the optiohs -that 
appeav- \y\ the widget 


-This is the sar^e 
^°dcl as bcW 



Put wait... you dow^ have to list al[the values like that 

It looks like a lot of work to put all of the options in the actual function call to 
OptionMenu (), doesn’t it? After all, there’s a large list of depots. 


Seattle, WA").pack() 


Catnbrld^ UK 
|SeaJttle h WA 
New York, NY 
'Dallas, TX 
! Eoston, MA 
jflojne, Italy 
Male, Maldives 
Luxor, Egypt 
.Rhodes, Greece 
Edinburgh^ Scotland 


Thankfully, Python comes to the rescue. If you have the options already 
stored in a list: 


depots = [’’Cambridge, MA M , "Cambridge, UK M , "Seattle, WA"] 


you can pass the entire list instead of separate values like this: 


OptionMenu(app, depot, *depots).pack() 


a^d msevt v^cvc- 


Now let’s put the pieces together. 
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adding options 



ExgrciSg 


This is a version of the program that uses radio buttons. 

You are going to update this program so that it uses an option menu. But the options need to be read 
from a text file. 

from tkinter import * 
def save_data() : 

fileD = open ( "deliveries • txt’ ，， "a" ) # 

fileD.write("Depot : \n n ) 
fileD.write( M %s\n" % depot.get()) 
fileD.write("Description : \n M ) 
fileD.write ( M %s\n n % description.get ()) 
fileD.write("Address : \n") 

fileD.write( M %s\n n % address.get("1.0" A END)) 
depot.set(None) 
description•delete(0, END) 
description•delete(0, END) 
address.delete("1.0 M f END) 

app = Tk() 

app.title( 1 Head-Ex Deliveries') 

Label(app, text = "Depot : M )•pack() 

depot = StringVar() 

depot.set 

Radiobutton(app, 
pack() 

Radiobutton(app, 
pack() 

Radiobutton(app, 

)ack () 

Label(app, text = "Description:")•pack() 
description = Entry(app) 
description.pack() 

Label(app, text = "Address:")•pack() 
address = Text(app) 
address.pack() 

Button (app, text = n Save n , command = save—data) .pack() 
app.mainloop() 



variable = 

=depot. 

text = 

'▼Cambridge, MA ", 

value — 

"Cambridge 

variable = 

=depot. 

text = 

'▼Cambridge, UK ", 

value — 

"Cambridge 

variable = 

=depot. 

text = 

"Seattle, WA M , 

value = 

"Seattle, 
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guis and data 



First, you need to create a function called read—depots () that will read the lines in a text file and return them to 
your code as a list. 


Hint: When you read a line from the file, it might have a newline character at the end. The rstrip () string method 
will remove it for you. 



Then, you need to replace this section of the code with code that generates an option menu using the data from the 
O read depots () function you just created. It should use a file called depots. txt. Write the code here: 
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options added 



ExeRciSe - 

Lvt\OH 

This is a version of the program that uses radio buttons. 


You needed to update this program so that it used an option menu. But the options 
were to be read from a text file. 


from tkinter import 


def save_data() : 

fileD = open("deliveries.txt ", "a") 

fileD.write("Depot : \n") 

fileD.write("%s\n M % depot.get()) 

fileD.write("Description : \n M ) 

fileD.write("%s\n M % description.get()) 

fileD.write("Address : \n") 

fileD.write("%s\n M % address•get( n 1•0 n , END)) 
depot.set(None) 
description•delete(0, END) 
description•delete(0, END) 
address.delete("1.0 M f END) 

app = Tk() 

app.title( 1 Head-Ex Deliveries') 

Label (app, text = "Depot:") •pack() 

depot = StringVar() 

depot.set 

Radiobutton(app, 
pack() 

Radiobutton(app, 
pack() 

Radiobutton(app, 

)ack () 

Label (app, text = _1 'Description : M ) .pack () 
description = Entry(app) 
description.pack() 


variable = 

=depot. 

text = 

'▼Cambridge, MA ", 

value = 

"Cambridge 

variable = 

: depot. 

text = 

'▼Cambridge, UK ", 

value — 

"Cambridge 

variable : 

=depot. 

text = 

"Seattle, WA", 

value = 

"Seattle, 



Label(app, text = "Address:").pack() 
address = Text(app) 
address.pack() 

Button(app, text = "Save ", command = save—data).pack() 
app.mainloop() 
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guis and data 


❶ First, you needed to create a function called read—depots () to read the lines in a text file and return them as a list. 


def read—depots(file) : S-tav-t 如払 a” 

. 

〕 depots—^ — opch(+ilcy 

Read -P\rom the -file OhC_ 

I'rnc at a time. 7?. : .?T. I 1 . 1 ??. 

%⑶ d a s^, PP ed do P y o-f - aepo-U.appchaa*me.v-stv-ipO) 

七 Ume *to 七 he a^ay. . ^ …" …… 工 r . r . 

\rc*tu\rr\ depots 

Rcb^vN V'st *to 
i\\t 6alV>^ todc 


Then, you needed to replace this section of the code with code that generated an option menu using the data returned 
©by the read—depots () function. It needed to use a file called depots. txt. You were to write the code here: 

Call the -Puh^tioh, passih^ \y\ £he 

-to \rcad the daia . 

心 ⑺州 . y options 二 read 一 depo*ts( w depo*ts *b^) 


Use tV^c data to V>u»ld ^. 0 P t，o ^ Chu(a ^ A ^ oi \ *°^ iohs) ； P adk( ^ 

0^t»OV\ 


you are here ► 


289 

























test drive 




Tesr DriVq 


Before you run your program, be sure to create the depots . txt file. When 
you start up the program in IDLE, the interface is a lot more compact and 
even easier to use: 



The system is working really well now. And, due to the depots being stored in 
a file, Head-Ex can change the list of depots in the file without having to amend 
the code in any way. 


y\\U Br\d ir^cat list o-f 
dcfo*t options 


Your GUI program builds the list of depots dynamically 
and on-demand, which makes it very flexible indeed. 
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guis and data 


Things arc going great at Head - Ex 

The GUI system is easy to use, and by restricting the depots with an option 
menu, the quality of the entered data is spot on. This means the Head-Ex 
delivery service is more reliable, the number of customers is increasing, and 
the business is growing bigger — worldwide. 




C^tcV out 

Using tkinter’s data models, you used the power of 
model-view-controller to build a GUI data-entry system 


that really rocks. 
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programming toolbox 



Your Programming Toolbox 

You’ve got Chapter 8 under your belt. 
Let’s look back at what you’ve learned 
in this chapter: 




^ 、 

_ 』 。舢”二 丨 ^ 

_ L a〆- 


; rods 

* T e ^() . j( - 1^. 

也‘〜 k , 

y 。’ 上 °巧:-:々‘ 

3 ’ 一 铷‘. f e 仏各〜 

匕: 1 ‘ whey> 


00 自 HPH.S 
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8 V2 exceptions and message boxes 

^ Get the message?+ 



Sometimes things just go wrong. You just need to handle it. 

There will always be things beyond your control. Networks will fail. Files will disappear. 
Smart coders learn how to deal with those kinds of errors and make their programs 
recover gracefully. The best software keeps the user informed about the bad things that 
happen and what should be done to recover. By learning how to use exceptions and 
message boxes, you can take your software to the next level of reliability and quality. 


this is a new chapter 
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the cheese stands alone 


Whafs that smell? 

Just when it looked like things were going so well, there was 
a problem in the Head-Ex storeroom. 



A consignment of cheese 
never got recorded and 
ifs been going bad in the 
storeroom. Weve had to 
issue gas masks... 


A trainee was recording the consignment of cheese when 
there was a problem that prevented the program from 
recording the delivery. That meant the cheese was never 
assigned to a delivery truck. So the cheese never left the 
storeroom and it just sat there for a very long time. And that 
meant — well, you can just imagine... 


To prevent the same thing happening again, 
you need to find what caused the problem. 
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exceptions and message boxes 


Someone changed the file permissions 



It turns out the whole thing was caused when someone from Technical Support 
decided to change the permissions on the deliveries . txt file, making it 
read-only. When the system tried to write deliveries into the file, it failed. But 
what’s worse, it failed silently: 


cv*vov 

message appeared m 
七 he $W I, the -t\ra*mcc 

-thinks cvc\ryih*mg is 0\(. 




w delWev*ies.W:” 

^""" y/ds w>ddc V"C3cl- 
or\ly. 


HlOQGC! 

1 Pn fltrpipf 

Ediiibur^li 

Scetlanj 


deliveries.txt 


The cv-\rov- m {\\t 

Py*t^or\ Slicll wSs ^ 
wt y\o*ti^cd by 
■bra’mee. 



When you were writing programs that ran in the Python Shell, 
you could always tell when it failed: a huge, ugly error message 
appeared. Why not with GUIs? Don’t they do the same? 

They do, but the trouble is that the message appears in the Shell 
and your user is busy looking at the nice GUI, so the ugly error 
can often be missed. 


When using a GUI, how do you spot errors? 
Once spotted, what happens then? 


Note: To reproduce this error on your PC, 
you need to make your deliveries . txt 
file read-only. How you do this depends 
upon your operating system. If you are 
unsure how to make a file read-only, check 
the Web for more advice (or ask a friendly 
local guru). On most systems, it involves 
editing the properties of the file. 
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making an exception 


Whew it couldn't write to the file, 
the program threw aw exception 

What happens when an error occurs? Some errors are really bad., they cause 
the program to crash. Other, less serious errors are known as recoverable: the 
program can keep running, even though something went wrong. You can spot 
these situations in your code, because most programming technologies throw 
an exception when they occur. 


Imagine a line of code that has a problem, such as the line that was trying 
to write to the deliveries . txt file. Python will spot that the append 
operation failed and, instead of running the rest of the code that follows, 
Python abandons ship and skips out of the code completely. That’s what 
throwing an exception means: the program doesn’t crash, but it abandons what 
you were trying to do and tries to recover the situation: 


TWis 1’me 
o*f to&t 
causes 

bo be 

*biiv-oy/r\. 



def save—data(): 

fileD = open("deliveries.txt ", "a") 

fileD.write("Depot : \n n ) 
fileD.write("%s\n n % depot.get() 
fileD.write("Description : \n") 
fileD.write( n %s\n n % description.get() 
fileD.write("Address : \n") 
fileD.write("%s\n n % address.get("1.0 r 
depot. set (’▼’▼) 

description•delete(0, END) 
description•delete(0, END) 
address • delete (’ ▼ 1 • 0, END 



END)) 


’ s skipped. 


But why skip past the rest of the code? Why not keep on running? Generally, 
that would be a bad idea. Once a line of code has gone bad, there’s no way of 
knowing if it makes sense to keep running the code that follows. For example, 
if the Head-Ex code can’t open the deliveries file to append to it, it makes no 
sense to continue trying to write data to the unopened file! 

In order to recover, you need to start running your code 
from somewhere else. 
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Catch the exception 


Python spots when an exception is thrown, and you can write some code to 
run when the exception occurs. This is called catching the exception. The code 
that you run when there’s an error resulting in the thrown exception is called 

an exception handler. 


def save—data(): 

fileD = open("deliveries.txt ", "a") 

fileD.write("Depot : \n") 
fileD.write( n %s\n n % depot.get()) 
fileD.write("Description : \n") 
fileD.write("%s\n n % description.get()) 
fileD.write("Address : \n n ) 

fileD.write("%s\n n % address.get("1.0 M A END) 
depot.set("") 

description.delete(0, END) 
description.delete(0, END) 
address.delete("1.0", END) 



h^hdlihg 
匕 ode. 


Creating exception handlers can really make life easy for your users. Instead 
of a flaky program that crashes or fails silently the first time something weird 
happens, you can write programs that gracefully recover from errors. Exception 
handlers tidy up when something goes wrong and can even let your user 
know that something strange happened. 

That’s what you need here: an exception handler that tells the user when 
there’s a problem writing a delivery to the file. 


How are exception handlers written in Python? 


A piece of cocte 
tkat runs wken 
an exception is 
tkrown is called an 
exception kandler. 
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try to except 


Watch for exceptions with try/exccpt 

In order to recover from an error as it happens, you need to indicate the code 
that might throw an exception. In Python, you do this with try and except. 

All you need to do is take the piece of potentially troublesome code and add 
the try and except labels: 


def save data() : 


try : 

Pu*t 

Vidytdler labels aro^d all 

o-f *tWis todc- 


CXdcptioh is thvoy/h 

/WYWttERE ih "this — 

sedtioh, the domputcir will 
jump -to the todt HERE. 


fileD = open("deliveries.txt ", "a") 

fileD.write("Depot : \n") 
fileD.write("%s\n n % depot.get()) 
fileD.write("Description : \n") 
fileD.write("%s\n n % description.get()) 
fileD.write("Address : \n n ) 

fileD.write("%s\n n % address.get("1.0", END)) 
depot.set("") 

description•delete(0, END) 
description•delete(0, END) 
address • delete (’ ▼ 1 • 0, END) 


-this Code 

is i^dch-ted 
-the u 



except Exception as ex: 


This is EXCEPTION 

I+ANPL6R todc ^ocs. 



Inside *thc is 

assigned *to a variable called 


If an exception is thrown between the try and except labels, the code 
that follows the except label runs. The code that threw the exception 
is abandoned. If no exception occurs, the code runs normally and the 
code that comes after the except label is ignored. 

Notice that the try/except labels are wrapped around all of the 
function’s code. If there’s a problem opening the deliveries . txt 
file, you don’t ever want to try writing to it. So, when trouble strikes, 
you should adandon ship and skip to the code that tries to recover from 
the error. 


The code that then runs is the exception handler. 
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Exception Magnets 


Assemble the code to handle an exception in the save—data () 
function. The exception handler needs to display the details of the 
exception in the title bar of the window. Note: remember to indent 
the code in the exception handler, in addition to the code in the 
try block. 


f ileD = open ( "deliveries . txt""a") 

fileD.write("Depot : \n M ) 

fileD.write("%s\n" % depot.get()) 

fileD.write("Description : \n M ) 

fileD.write("%s\n" % description.get()) 

fileD . write (▼▼ Address : \n") 

fileD.write("%s\n" % address.get("1.0 M A END)) 
depot.set ("") 

description•delete(0, END) 
description•delete(0, END) 
address . delete ( "1.0" END) 



Q 





you are here ► 


299 






















exception handler 




Exception Magnets Solution 


You were asked to assemble the code to handle an exception in the 
save_data () function. The exception handler needs to display 
the details of the exception in the title bar of the window. You 
needed to remember to indent the code in the exception handler, in 
addition to the code in the try block. 



fileD = open("deliveries.txt ", "a") 

fileD.write("Depot : \n n ) 

fileD.write("%s\n" % depot.get()) 

fileD.write("Description : \n M ) 

fileD.write("%s\n" % description.get()) 

fileD.write("Address : \n") 

fileD.write("%s\n" % address.get("1.0" A END)) 
depot.set("") 


description.delete(0 , END) 
description.delete(0, END) 


address . delete ("1.0",- END) 


TVi'is is i\\t ^ 

Ka^dlev- dodc- 


except I ^ExceptionJI ^as^j 厂 s x: j 

Can ，t writeTo th e filers 


㈣ 上辦 嫌 . 


K r, 





scvcv-al lihcs 3s lohg 3s they 
all ihdch-fccd ih the same way. 
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Tesr DriVq 


Let’s see if the code works. Make sure the deliveries . txt file is read¬ 
only. Then run the new version of the program in IDLE and try to record a 
delivery by clicking on the Save button. 

w Sav^ 

causes 

ti-tlc bav- *to 

due -to 



Uoic make suv-c 
dclWcv-ics.-t^t »s 
sc*t *to v-cad-o\r\ly. 



deliveries.txt 


Can't write to th& file [Errno 13] Permission denied: 'icllvcncsrtxt 1 


error- 


Diepot 


DeEcription^ 
Stinky Cheese 

Address: 


j^jtinka-R-Us 

47 ril m 1 h |]f]ii<j dv^rkiiH 
L>all 3 iS F K X 



Sure enough, when you try to save the delivery details, the program catches the 
exception and the exception handler displays the error message in the window 
title. 


Wonder what the people at Head-Ex will think of this? 
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unexceptional exception handler 


There's aw issue with the exception handler 

You do a quick demo for the folks at Head-Ex and, even though the program 
works, it’s not quite what they need. 


rm not sure the error 
message is really visible 
in the title bar. If there 
is an error, I really don’t 
want to miss it. 


O 


o 



The error message is more visible than when it was appearing in the Python 
Shell, but it isn’t a whole lot more visible. Sure, you’ve proved that you can 
spot when an error happens and then run an exception handler in order to 
do something about the error. But you really need to do something that will 
interrupt the user and highlight the situation. You need something that will 
force the user to acknowledge the error before he continues doing something 
else. 

A GUI message box might do the trick. 
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A message box demands attewtiow 

Most of the time, GUI programs put the user in charge. If the user chooses 
to click a button or edit a field, the computer lets them do just that in 
whatever order and at whatever time the user chooses. But sometimes, GUI 
programs need to stop the user and ask her a question, getting her to confirm 
or acknowledge something. That’s where message boxes come in. 

A message box is something that requires a response, which is why it’s 
sometimes called a dialog box. 

The simplest message box displays a message with a single OK button: 


TVis sKows 


Sour hover cra^-t is ^u\] eels! m - This is 



uoarniaa 



message. 




TV^c usc\r must c\\eV butbm 

adk^oy/lcdjcs i\\t message- 


A message box always displays the message in a separate window, typically 
in front of your main GUI window. And it won’t go away until you click 
it, dismissing it. That’s why message boxes are the most commonly used way 
of displaying errors. The user has to read and respond to the error before 
continuing. 

You should be sparing in how often you display message boxes, because if 
users see too many of them, they are likely to click them without reading the 
message. But, when used carefully, they keep your user informed and alert. 
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declarative and interrogative messages 


Creating message boxes m Python 

All of the message box code is contained within a tkinter module called 
messagebox, so the first thing to do is import the module: 

import tkinter.messagebox 


Then, you’re good to go. Within the messagebox module, there’s a whole 
bunch of different dialogs to choose from. But all of them fall into two main 
categories. 


Message boxes that say stuff 


To display a simple message on the screen, you might display a message box 

like this: 丁 . 广 

I he o\ the message- 


匕 o 灼 "terr 

I 


tkinter.messagebox.showinfo("Delivery ", "The cupcakes have arrived in Istanbul ，，） 

TKc message bo%_. —- 



"Hie idoh ih the v/ihdow shows 
that this is just -Po\r ih-Pov-matioh. 

You *to 0 ^ 

bu*t*bo^ £>losc dialog. 


o&Uver^ 


仆 e aupcaKes have at \ ^ 


■9* ' — 一 1 


OK 


Message boxes that ask stuff 

If you need a message box that asks the users a question, you will need to 
check the return value to see what they chose: 


response = tkinter .messagebox • askyesnocancel (’’Gift ?’，， "Gift wrap the package? M ) 


value is assi^cd *to w v*cspohsc ; 

i\)t us 饮 dlldks OY\t o-f *tv>c buttes. 

When tkinter gets to this line, it will wait for the user to 
answer the question and then assign True (yes), False 
(no), or None (cancel) to the response variable. 


Let’s see what other message boxes are 
available. 
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exceptions and message boxes 






4r 





These are the message boxes available in tkinter. Think carefully about 
each of the following examples. We know which we’d use at Head First 
Labs. Which type of box on the left would you choose for each of the 
messages on the right? Connect the messages to the boxes with lines. 


showinfo 


showwarning 


showerror 


askquestion 


askokcancel 


askyesnocancel 


askretrycancel 


“OK to fire boosters?” 


“Your tartan clogs have arrived.” 


“Seriously，I think he’s just ignoring the phone.” 


“Danger, Will Robinson!” 


“Do you want fries with that?” 


“Dude, the printer’s busted.” 


“So, you want Nutella on your bacon and jelly sandwich?，’ 
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mixed messages 


-f 




4 r 




These are the message boxes available in tkinter. You were to think 
carefully about each of the following examples, then indicate which 
type of box on the left you would choose for each of the messages on 
the right. You were to connect the messages to the boxes with lines. 

/\v-c you REALTY su\rc you y/a# *to 

COY\ tmuc do tuf IVs youv 

匕广 last bo youv w>md. 

OK to fire boosters?” 





This is pu\rc ’n^fov^atio 灼. (Vo-thmg 
■to v/o\r\ry about ihc v-isk o-f 

^ - 匕 lash’mg y/i-th you\r vdvci hood- 

Your tartan clogs have arrived.” 


I 七 A\dr^i y/ovk last but \( you like, you tvy a^am- 

. 4 / 

Seriously, I think he’s just ignoring the phone.” 


0\(, SO ihcvVs ad*tually 

“Danger, Will Robinson!’ 卜 bv-okcr^ YBT, bu*t B£ CAR£f*WL 

You 3V"C "to 乙。灼七 … 心 W 七 

^ do you y/ant tWis extra Ofticw? 

“Do you want fries with that?” 




Stu-Gf^s b\rokch- Vou Y\tt& bo know. 


“Dude, the printer’s busted. 


?5 


CC 


y/ay\*t t^'is additional option, or would 
you {-.kc bo about tv^c y/^olc tWf 

So, you want Nutella on your bacon and jelly sandwich?” 


p*,a youv- ay>sy/cv^s maidK ouv-s? TKcy 州吵七⑽七. Sclcdt.^ v,h*.dV> iy ? e o( message bo% *to use 
defends d \oi i\\t fa^rtidulav program youVc y/\r'rt*m5 ar>a lioy/ senous you *tVmk a dcdisioh IS. 
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^Sharpen your pencil 


The folks at Head-Ex want your program to display this message 
box if there’s a problem saving a record to the 

deliveries . txt file: 



brror 


Complete the missing lines in this section of your program to create the message box. 


C-dn t ugn ^ 


l i ■Rei nuon dded: 


Hint: You need to include a newline in the message box text. - 




from tkinter import 


def save_data() : 
try : 

f ileD = open ( "deliveries . txt" ，- "a") 

fileD.write("Depot : \n M ) 

fileD.write("%s\n n % depot.get()) 

fileD.write("Description : \n n ) 

fileD.write("%s\n M % description.get()) 

fileD.write("Address : \n") 

fileD.write("%s\n n % address.get("1.0 M f END)) 
depot.set(" M ) 

description•delete(0, END) 
description•delete(0, END) 
address . delete ( "1.0" END) 
except Exception as ex: 
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get the message 


i^Sharpen your pencil 
K Solution 


The folks at Head-Ex want your program to display this message 
box if there’s a problem saving a record to the 

deliveries . txt file: 



Lrror 


Cant 






we 




l Eirnc muon der.ed ： 




Complete the missing lines in this section of your program to create the message box. 

Hint: You need to include a newline in the message box text. 

from tkinter import * 

*tkm*tcr.mcssa^cboy. 

Rcwcwbcv* to 
iw\Pov*b 七 ^ 

y^CdCSsavY module, def save—data (): 

try : 

fileD=open("deliveries.txt n , "a") 

fileD.write("Depot\n M ) 

fileD.write("%s\n n % depot.get()) 

fileD.write( n Description\n M ) 

fileD.write("%s\n n % description.get()) 

fileD.write( n Address\n n ) 

fileD.write ("%s\n M % address . get ( " 1.0 " END)) 
depot.set("") 

description•delete(0, END) 
description•delete(0, END) 
address . delete ( "1.0" END) 
except Exception as ex: 

*tkm*te\r.messaybo%.showe\rro\r( l 、 &rro\r"’ ， “Car / 七 w\ri*tc to -filAh %s” ％ c%) 

. .. 

j OU shou ^ usc showc\r\ro\rO -Puhdtioh so that 
七 he dialog box gels the cv-vov- \Coy\. 
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Tost DriVq 


Now what happens if you try to save a record when the deliveries . txt 
file is read-only? 



Irlead-Ex Deliveries 


Depot: 
Rome, lltaly 


Bucket of Parmesan 
Addre&s: 



The Holy See Suppliers, Inc. 
42 Vatican Way 
Rome, Italy 


This is ERROR message bo%. 


"The idoh shows ^ 
the usc\r that 
sorhctlimg has 
Johc v/\roh0. 



⑬ 


Great! The exception handler displays an error message 
with an icon that really alerts the user to the problem. 
Let’s check back with Head-Ex to see if they like it. 
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durian delivered 




The error message box was exactly what 
Head-Ex needed. 

By catching exceptions and displaying 
important information in message boxes, 
you can greatly improve the experience of 
your users when things go wrong. 

Great work! 
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exceptions and message boxes 



Your Programming Toolbox 

You’ve got Chapter 8.5 under 
your belt. Let’s look back at what 
you’ve learned in this chapter: 


0 yd"' - 


arc 


* M 沙 ay WeS • 心 ㈣ 七 

^ “ W 


t as w、M Wcs . 

a \so Yr\0^ ds 

L 0 y-CSVOV'A) tyii 
. # L\^ t ^SCV tP^ C V 



伙批 。 hS fey U5 ., 

by 、 V ， 



浃 （< en tr 

^/vixtr d v xw w,,/ ^ ^ 

，⑶， ;:： y 、 

* : 巧〜‘〜 

r 二 :: r 〜〜 
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9 graphical interface elements 


參 Selecting the ♦ 

% right tool 



It’s easy to make your programs more effective for your users. 

And when it comes to GUI applications, there’s a world of difference between a working 
interface and one that’s both useful and effective. Selecting the right tool for the right job 
is a skill that comes with experience, and the best way to get that experience is to use 
the tools available to you. In this chapter, you’ll continue to expand your GUI application 
building skills. There’s a bunch of truly useful widgets waiting to be experienced. So, turn 
the page and let’s get going. 


this is a new chapter 
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dj goes digital 


Time to mix it up 

Your best friend is an ultra hip DJ with a problem: his vinyl 
collection is now so large that he can’t carry it all around 
from club to club anymore. He’s decided to digitize his entire 
collection, put it on his laptop, and mix his sounds from there. 
His problem is that commercial mixing software costs a fortune 
and he doesn’t like any of the free alternatives. He has his 
own ideas for the mixing software he wants. 


Tm dumping vinyl and 
going digital. Can you help 
me write my software? 

I need to be able to start 
and stop a track. 


What with spending all his time mixing music, he’s never 
learned how to program his computer... and that’s where you 
come in. If you help him to write the software he needs, he 
promises to showcase your work at the upcoming World Music 
Mixing Expo. 

Let’s build the mixing software bit-by-bit based on the DJ ? s 
requirements. 


All -tWis V^as b> 
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Code Magnets 

A couple of buttons on a GUI ought to do it. Here’s the code to a 
small tkinter program that starts and stops a sound file. Rearrange 
the code magnets to make the program: 


from tkinter import * 
import pygame.mixer 


track = mixer•Sound(sound file) 


def tracJc —start () •• 

■!^_Pla y(loopg 


- 1 ) 


stop_button = Button(app, command = track 一 stop, text 
stop button.pack(side = RIGHT) 


Stop’ 


a PP- mainloop () 




def track__stop ()： 
track.stop() 


mixer = pygame 
mixer.init() 


mixer 


—H file = ” 50459 』」^ 


N eph 1 imi z e it 


wav’ 


app = Tk() 
a PP•title("Head First Mix") 
app.geome try( f 250x100+200+100 
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start and stop 



Code Magnets Solution 

A couple of buttons on a GUI ought to do it. Here’s the code to a 
small tkinter program that starts and stops a sound file. You were 
asked to rearrange the code magnets to make the program: 


from tkinter import * 
import pygame.mixer 


Import 払 C \rc<\ui\rcd 1'iWa^CS. 


app = Tk() 
app.title("Head First Mix") 
app•geometry( ， 250x100+200+100 ， 


Create <^U| a^li^at»on w’md 

-the PJ^s 


sound file 


50459 M RED Nephlimizer.wav' 


mixer = pygame. 
mixer •init() 


mixer 


Tk 一 -Puh^ioh . 
will -to the u S-top w 

buttoh-didk cvcht 


def tracJc —start () •• 
^^P^yOoops 


-i) 


def track 一 stop() •• 
track.stop() 


Star 七 soured system. 

The '"tv-adk__s-t3\rt( y l v/ill vespohd 

"to "the 七 ” butte 灼 - didk 

: rk w loofs 二一广 paramcW *to W 
vocals brack until you st>\> 




.l^-Load up the br^ck Souhd -Pile- 

track = mixer •Sound(sound_file) 


Cv-ca*tc a Wtbcm *fov* 

w S*taW 扣 dl w S-to\>/' 
cov\Y\tci ca^ c^P 从加 *toN^ 
{\\tW cvc\r\*b V^dlevs. 


^tart__button.pack (side = LEFT) 


track—start, text 


=»» 


Start") 


stop 一 button = Button(app, command = track—stop, text 
stop 一 button.pack(side = RIGHT) 


Stop") 


Sta\rl i\)t ^Ul cvcht loot 




this! 


Download the sound tracks for this chapter from the Head First Programming 
website. Be sure to put the sound files in the same directory/folder as your code. 
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graphical interface elements 



Tesr DriVq 


Enter the code from the previous page into IDLE, save it as hfmix . pyw, 
and press F5 to try it out. 


- ome/barryp/HeadPIrstPro^/chapter3/cod«/sta q eo~ 


File Edit Format £un Options Windows 

f rom tki nt er iir 

pygame-mixer 


a.pp — T k() 

app.title( "Bead First Mix" ) 
app. geoioetry ( ' 230X100+Z00-M00 ' 


not ]nd f i 1 fi = M HER N^plil 


raixci: — pYgauie _ mixer 
mixer.init() 

j i_- f Lx dc k a Ld l t (); 

track.play(loops 


Jtr I aLupt I 

track. st<Dp() 


tracK = mixer.sokind(sound rile) 


start button = But,t,on( ^pp r comniand = track start F text, 
3 1 ar t_mt t on. pac Jc {s ide = LtlFl'l 

stop button = Button(app 
stop button.pack(aide 


The -Pi\rs-t vc\rsioh 
七 he DJ’s 

pirogiram Chtcvcd ih 

IDLE. 



You already know how to display buttons on a GUI and 
associate them with event-handling code. What’s new in this 
code is the loops = -1 bit, which arranges to play the sound 
repeatedly. That is, the track loops. 

That was almost too easy! 



Thafs not a 
O 7 bad start... 
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stop the music 


The music just kept on playing... 

In his haste to show off your program to his DJ rivals, your friend 
fired up the program as is. He didn’t realize that the track you 
included by default is pretty bad. In a panic, he clicked the window’s 
close box before pressing Stop, and the awful track kept right on 
playing. His rivals haven’t had such a good laugh in ages... 
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graphical interface elements 


Not all evcwts arc generated by button clicks 

Your GUI program processes lots of events, not just the events generated by your 
user when, for instance, buttons are clicked. 

Your operating system can send events to your GUI program, too. Some of these 
events are commonly handled by the graphical programming technology you 
are working with. For most of the operating system’s events, tkinter very kindly 
handles them for you. When you click the close box on your GUI, this generates a 
Window Manager event for your code to handle. If your code doesn’t handle a 
Window Manager event, tkinter handles it for you in a default way, too. 


Youv- usev- 

butto 灼 - dU 

一 I 





l/Vait -Po\r ahothev cvch-fc. 








Ruh the cvcht-hahdlihj todt 
associated W i-th whatever 
eveivt o^^uv-v-cd 
some default d^iioh. 


Thc 

9^c\ra-tcs ah C v Ch t 

W ^ Ch useir clicks 
。的 the dose box. 



If the default event handling isn’t what you want, you have to capture the event 
before it gets to tkinter and is handled in the default way. At the moment, the click 
on the close box is being handled for you by tkinter and the default behavior is to 
close the window. 


Let's take control of this default behavior. 


you are here ► 
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the cost of interactive loveliness 


Frank: What’s up now? 


Joe: Well, it looks like I have to worry about lots of other GUI 
events, not just my own. 

Jim: Yeah. It appears the operating system and this Window 
Manager thing can give the GUI application work to do. 

Frank: Yes, that’s right. All that interactive loveliness comes at a 
cost. 

Joe: Cost?!? You mean we have to pay? 

Frank: No, not that sort of cost. You sometimes need to write a little 
extra code to interact with the Window Manager when and where 
necessary... that’s what I mean by “cost.” 

Joe: Phew! So... what’s a Window Manager, anyway? 

Frank: It’s something built into every GUI application that handles 
the management of your application’s windows. Python’s GUI, 
tkinter, has a Window Manager, as do all the other GUI toolkits. 

Joe: So, how do I work with the events generated by the Window 
Manager? 


Frank: You create a function with the code you want to run and 
then connect the function to the event. 

Joe: OK, I get that. But which event do I connect up to? It’s not like 
the Window Manager has a button to click on, is it? 

Jim: That’s a good question... Frank? 

Frank: Well spotted. What happens with the Window Manager is 
that there’s a set of protocol properties that you can interact with as 
and when required. 

Joe: Protocol what? Properties? 



You see, GUIs might look 
nice and easy, but they are 
actually a pretty complicated 
beast under the hood. There's 
lots of different events to 
worry about. 


Jim: Yeah, you’ve lost me there, Frank. 


Frank: Yes, protocol properties... they really are not as scary as they 
sound. Remember: with GUIs, it’s all just code. 


Jim & Joe: Where have we heard that before... ? 


Frank: Here, let me show you what I mean... 
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Study the three tkinter properties presented below and see if you can 
match up the properties to the correct description: 

WM_TAKE_FOCUS A message sent to your main window 

when the operating system is shutting 
down 


WM SAVE YOURSELF 


A message sent to your main window 
when the close box has been clicked 


WM DELETE WINDOW 


A message sent to your main window 
when the window has been selected 
after a mouse click 


Which of these protocol messages do you think you need to capture? 


■晰 —— 

The tkinter library provides a mechanism to 
react to an event that is associated with the GUI 
window. These are known as Window Manager 
protocol properties. Think of the event as a 
protocol event. 


you are here ► 
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capture the event 






罾亀 ■ 輩， - 

• + 鬌亀 ▼ 你 ， i 


You were to study the three tkinter properties presented below and see 
if you could match up the properties to the correct description: 



A message sent to your main window 
when the operating system is shutting 
down 

A message sent to your main window 
when the close-box has been clicked 

A message sent to your main window 
when the window has been selected 


after a mouse click 


You were to identify which of these protocol messages you think you 
need to capture: 

顧 DELETE IVINPW 


First Mix 





Controlling the Window Manager 


To capture the event before it gets to tkinter, call your app’s 
protocol () method and identify the function that should be 
called instead of executing the default behavior: 


You'll V^avc -bo exts^t *bV^c 
w sliu , tdioy/K \ ， -fur\dtioir\. 




Be su\rc -to dal I 

YoUoKr BEFORE 

、 aihloopO”. 



Associate the CVCht- 
•fuhd'tioh 

with the pv-opevty. 
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graphical interface elements 


f your pencil 



Now that you know about window manager properties and how 
to capture them, write the code for the shutdown () function: 


tV>e 6ode so 


Pu 七 如 ，， 


from tkinter import * 
import pygame.mixer 

app = Tk() 

app.title("Head First Mix") 
app.geometry('250x100+200+100*) 

sound—file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame.mixer 
mixer.init() 

def track—start(): 

track.play(loops = -1) 

def track_stop() : 
track.stop() 


track = mixer•Sound(sound—file) 

start_button = Button(app, command = track—start, text = "Start") 
start—button•pack(side = LEFT) 

stop_button = Button (app, command = track_stop, text = "Stop") 
stop_button.pack(side = RIGHT) 


tV>e 6ode so 


Pu 七如 ，， 



app.mainloop() 


you are here ► 
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sAmfc/o 霞 function 


^rpen your pencil 
^ Solution 



Now that you know about window manager properties and 
how to capture them, you were asked to write the code for the 

shutdown () function: 


from tkinter import * 
import pygame.mixer 

app = Tk() 

app.title("Head First Mix") 
app.geometry( 1 250x100+200+100*) 

sound—file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame.mixer 
mixer.init() 

def track—start(): 

track.play(loops = -1) 

def track_stop() : 
track.stop() 

drf shu*tdovmO: 



v/iien y/mdoy/ closes. 


track = mixer•Sound(sound—file) 

start—button = Button (app, command = track—start, text = "Start") 
start—button•pack(side = LEFT) 

stop_button = Button(app, command = track_stop, text = "Stop") 
stop_button.pack(side = RIGHT) 



app.mainloop() 
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Tesr DriVq 



With the changes made to your program in IDLE，press F5 to see how things 
perform now. 


hfmtx.pyw - ^hom^vbarryp/Kead F ErctP rog . ! c liapt^rdyc^d 


£ilp frlit rnrmflt _Qiin Opt ion \ Wmrtow^i 
:1 - rr t winter ippoi' - * 

|ty tjsH rru^. m i T+fr 

^£■£3 = Tk () 

app.tit 丄 c ( ■’ad firot DUk." > 
fipp^.[jtfl]mn I j y ( ' 7 n if ■: fl 1-7 *'ifi ^ 1 Ifl 


tV>c tlosc — 咖七 

av^y … 

^ Click! 


? 1 HILI 3 ]C] F L lil-S 


■ 『 ■(541 呼 H RED Ntiphl itti 


□a3 »nr = pyijrirra-!；^.rna xmt 
QiKer. init" 

•2 * ■ : tracit_atart [) s 

t mez'k ■ p 1 Ay 彳 1 npnpjn 

rlef t rn-rik ."vh.ri'p^ [i : 

tracK. Btop( I 





Click! 


\ 




.It r entstdovTn () ? 
track.atop ㈠ 

track - uiiMcr. Sound*{aound_filc \ 
track 一 playing - IntVox ㈠ 

9tart_t5utton = But to-n {app r coira]iaEi(3=t rac?lt_3t art , r teyt 
atart_button.pack( aide LEFT) 

a top 一 button = Button (app r eomraand: =* traefc 一 stop, text 
at op_button. pack (aide - HI G]]T )i 

app.protocol ( "WH 一 DEIXTE_WINDOtT , ahutdo 

app. f：.nin loop () 


'wihdow jjo dlosc. 


What gives? You’ve solved one problem, but created another. 
When the DJ clicks on the close box, the track stops playing, 
which is what you wanted. But now, the window won’t close. 

This can’t be good, can it? 





[you are here ► 
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terminate with extreme prejudice 


Capturing the protocol cvcwt isn't enough 

Your code captures the protocol event and redefines its behavior. But, what 
about the behavior that used to execute by default? 

Take a look at this small example program, which redefines the close-box 
protocol to check with the user before actually destroying the window: 


from tkinter import * 

from tkinter.messagebox import askokcancel 

app = Tk() 

app.title("Capturing Events") 
app.geometry('250x100+200+200') 

def shutdown() : 

if askokcancel(title 
app.destroy() 




Da fMs! 





cm 七 ^ c\ost bo% i\\t 
WW, wWA 七 ^ 
displays an AskOkCa^cl dialog 


|-f you ditk ,s 

destroyed (y/Widh 
^losm^ y/'mdow). 


Add the app . destroy () line of code to the end of your 
shutdown () function and see if it makes any difference. 
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Tesr DriVq 


You’ve added in the line of code that terminates (destroys) your GUI 
application. Now, press F5 to see what happens. 



hfmlx.pyw - /harryp m eadFInlProxn/chaptfi 


£iIp [rlih rnrmRt lliiin Ophnm^ 迎 inrinws 

: i' r tkintcr : " * 

..u clujl£! . 丄 xtf X ： 

ajjp = ) 

ap|5 ™ t it 丄 c ( ， Uc-adl t irc t Him _ } 

d.pp ,ytfuiiutfLi;y I ' 2 30xlGD 十 2 00 會 1 GO a )> 

nou:a3d r 丄 M RED Htfuhl 丄 tzmtfi* - wav 

IH - ' Bi 

miKd ： = py . inJi JLhf i: 

aiHcr.initH 

: tracjt_3tQE ： t!| ) : 

t. r rl E：V . £ll ny ( l [ M 3i[1?f = —1) 


I rriL:k Hl.Lip^ ^ 7 
tZTGiCiC . atopf ^ 

:乂 atintdavn [) : 

I I rtc：k . Mi L.[l>p( \ 

app T destroy (| ) 


TVis c%*tv-a Imc o-f 
乙 ode makes all 
di-f-fcv-cr\dc. 


t racK - b.i kcx . Sound i| aounel_t i icl 

t riiGii_j5 丄 aying ■ IntVar^ ) 

n,E L. liEit.I.iiii = [hnim^tml= l.w^ lzI; ^1 /ir I., 

at art_but ton. pack (aide - UJfTJ 

IiLeI.L.IKEE = L ： [|[SniriI3[] = l.I rl[：k MiL.Elip, 

AtDp_l3nitton,pacK [ Bide - MIGHT3 

app. protoc d 丄 t "Wn_DLL± ： TI；_Wl NUL：,-. J 日 hu tnown) 

app,caj.nioop () 


IJpJp 


t.«jt L. 


.Si riE 


LsKJtlL = 


Your GUI is not only doing what the DJ wants; it’s behaving itself, too. By 
redefining the protocol event associated with the click on the close box, you 
are able to stop the track... eh... in its tracks. You also ensure that the default 
behavior associated with the click is performed by arranging to destroy the 
GUI application. 



]^l)ntY\ you t\\cV ov\ *bV^ 

dose bo% y\o>n, 今 IXI 

apfl 化 disafpeav-s. 

咖乩 V^clfs v/V^y you 

see *»*t oy \ *tWis pay 



That’s greats 


327 














toggle time 


Two buttons, or wot two buttons? 
That is the question... 



The DJ is happy with the program so far. However, he thinks it would work 
better if he had just one button instead of two. He’s convinced this would be 
easier to use, because he wouldn’t have to move his mouse around the screen 
quite so much. 


Speeds important, dude. 
Can’t I just press the 
button to start the track, 
then press it again to stop 
it? 



buttans or not 2 buttons? 



_ "the hext di 乙 k 

om s-top whatever 
this bu-t-toh dc 


Iocs? 


It is possible to use a single button here but, without changing the physical 
appearance of the button each time it’s clicked, a user can’t possibly know 
what state the button is currently in, even though the DJ does have ears in 
this instance. But, in general, using a button to switch between two states is not 
regarded as best practice in GUI design. 

What your DJ friend actually wants is some sort of visual toggle... 
something that can be flipped between one of two states: on/off, open/close, 
flip/flop, and so on. You need to use a different graphical interface element. 


Is there a GUI visual toggle you can use here? 
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graphical interface elements 




E%ew：iSe 


Take a look at the following window that appears when you ask a full-featured web browser to 
display its preferences. Grab a pencil and draw a circle around any graphical interface elements 
you haven’t worked with yet. 


Shkretoko Preftiranees 


Tdbi CarilKiil Applicdliurih. Privdty Set-uriLy AdvdiriL^d 


whnn shirrmkn Shaw my winrinw^ .mrl r.Ths from ln?it timn 


Home Page ： 

hitfy ■ ⑽ ww. pytli&n.org/ 



Use current l^gcs, use ^ookrmork 

议 ? store ucf^uJt 



Downloads 

@ Khfiw rtipnownlnart 1 ； wmriow when rinwnlonriing n filf! 
I Close it when aft downloads aw finished 




De&ktop 


AlwFiys ask me where to fWe.s, 

Add-ans 

Change preferences for your add-sns 


From the elements that you have circled, identify one that might be of use to you in your program. Which 
would work best as an on/off toggle? 

l/Vv-itc youv- a^sv/cv hcv-c. 


you are here ► 
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check on the checkbox 


ExenciSe 
SotvtlOH 


Take a look at the following window that appears when you ask a full-featured web browser 
to display its preferences. You were to grab a pencil and draw a circle around any graphical 
interface element you haven’t worked with yet. 


Shlrotoko Pref«r<ancet 


^scd 



Htiin 


Tdb& CorilKiil Privdty S«Lurily AdvdMLtfd 


startup 

whRr shirrrnkn 


Shaw my winrtnws .inrl r.Th '； fmm Inr^t rimn 


Home Page ： I http ： //www.pytlion.ong/ 



S h；hfiw rtip llownlnaft 1 ； wmriow wh^n rinwnlonriing zi 
二 Close it when al.[ downloads are finished 


■#. Eiivf' fiJ^s ro 


Alwnys ask me where to files, 

Add-ans 

Change preferences for your add-sos 


From the elements that you have circled, identify one that might be of use to you in your program. You 
were asked to identify an element that would work best as an on/off toggle: 

The dhcdkboy. is 

ci"thcv* o\r o-p-p. 丁 ^ dKcdkboy. 
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graphical interface elements 


The checkbox is an ow/off, flip/flop toggle 

The great thing about the checkbox graphical interface element is that it can 
be in only one of two states, either on or off. Depending on the current state 
of the checkbox, an object can be set to either 1 for “on” or 0 for “off.” 



Ckk 

a^d set 
i\st object ^ - 


P ick 知 kbox 仫 
\i ahC | sc i ihc 




Ah, phooey! Set 
that object to 0, 
which is, like, oooh. 


In tkinter, checkboxes are created using Checkbutton ()， and they can be 
associated with a tkinter 工 ntVar ， first introduced in Chapter 7. The tkinter 
Checkbutton () is either on or off and sets the associated IntVar to 
either 1 or 0, which is perfect for what you need. 


Let’s look at using a checkbox in tkinter. 


you are here ► 
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flip it off 


Working with checkboxes m tkmtcr 

The tkinter Checkbutton needs three things: an IntVar to hold its 
current value, an event-handler function to run when it’s ticked, and a 
descriptive label to say what it does. Take a look at this example code: 


The 

-Puhdtioh is -the 

OiCdkbut-fcoh^s 
CVCht hdhdlev'. 




flipper 


the dhcdkbox is tidked- 


def flip—it(): 

if flipper.get() 
print ("Cool. 
else : 


I'm all ON, man 


print("Phooey. I'm OFF. 


TV CV^kW 七 3 
dsso^id'bcd Wi*bV\ 
U\/a/, Uks 如 
Ka^dlcv, and V^as 
a dcstv-\\>*bwc label, *to<>- 


Checkbutton(app, variable 

command 


Using the get() method 



If you look closely at the code for the flip—it () 
event handler, you’ll notice that the message displayed 
on screen is controlled by whatever value is returned 
from the call to flipper . get () . The get () 
method is part of every IntVar object, and it lets 
you easily determine, in this case, the current value 
associated with the flipper variable. 

But, what sets the value? 

The Checkbutton automatically sets the value of 
flipper as a result of the click on the checkbox. 
Tick the box and the value is set to 1. Untick the box 
and the value is set to 0. 
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graphical interface elements 


O Here’s your code from earlier. Use your pencil to put a line 
through the code you don’t need anymore: 


app = Tk() 

app.title("Head First Mix") 
app.geometry('250x100+200+100') 

sound—file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame.mixer 
mixer.init() 

def track—start(): 

track.play(loops = -1) 

def track—stop(): 
track.stop() 

def shutdown() : 
track.stop() 
app.destroy() 

track = mixer•Sound(sound—file) 

start—button = Button(app, command = track—start, text = "Start") 
start—button•pack(side = LEFT) 

stop_button = Button(app, command = track—stop, text = "Stop") 
stop 一 button•pack(side = RIGHT) 

app.protocol( n WM—DELETE—WINDOW", shutdown) 
app.mainloop() 

© Write the code you need to implement the checkbox here, based on the sample code from the previous 
page. Give your 工 ntVar the name track_playing. Use track—toggle as your function name, 
and call the checkbox track button: 


^Sharpen your pencil 


from tkinter import 
import pygame.mixer 


you are here ► 
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checkbox added 


Sharp your pencil 
^ Solution 


O Here’s your code from earlier. You were to use your pencil to put a 
line tf 


through the code you don’t need anymore: 


from tkinter import * 
import pygame.mixer 


app = Tk() 

app.title("Head First Mix") 
app.geometry('250x100+200+100') 


sound—file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame.mixer 
mixer.init() 


h p V—n 计 （）• 


nk pi n ^ fl nnp n 


-de^ 1 h .ml: rrL aa p () 


fcr 


track 


= ^ - 

TV^c tVia-t start and 

-tv-atk av-c v\o lo^yv- needed- 


def shutdown() : 
track.stop() 
app.destroy() 

track = mixer•Sound(sound—file) 

Gtart—button - Dutton(app, — mmand 

一 A —― 一 n pn { o j p|Q 二 T-rFFTt - 

° — 〖 丨 1 丨 1 " n 丄 ---il (oHHp = - . 


da 灼 b\so yt v*id o-f the "tv/o bui^ttohs, 
siMe they a\re〆 七 needed ciihcv-. 

\c 

= 用叶 「 ~~ feext - ~~ "Start M ) — 

text - ".Gtop") 


❺ 


app.protocol( n WM_DELETE—WINDOW", shutdown) 
app.mainloop() 

Write the code you need to implement the checkbox here. You were asked to give your IntVar the name 
track playing, use track toggle as your function name, and call the checkbox track button: 


Tk w *braHf WW 

flays ov 

based ov\ *b^c state ok 
七 he Aetkloo 乂 . 


drf *bradk 一 *to%leO: 

i-f *bradk 一 playmgytO 
■tradk.playOoops : 

else ： 

*tradk.s*top() 

*tradk_play'm5 — IhWarO 


All of 七 Wis todt ^ttds -to 
fee added youv 

BEFORE ^all 

wamloo^O . 


Wsc the ha^C o-p the SOUhd 
-Pile as the text associated 
with -the dhcdkbox. 


*bradk_bu*t*to 妁二 Chedkbu*t*tor\(afp, variable =■ *tv-adk__j>lay'm^ 

- ^ *twt 二 souhd -file) 


*br^k_bu*bto 妁 padk 。 
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Tesr DriVq 


With your program amended to include the checkbox code, let’s 
run the latest version of the DJ’s program in IDLE and see if the 
checkbox works as advertised. 



pyw - /hom lyp/HeadFirst ProNg/ch spt*r6i/ci 


£ilp 「flnnAT flun 巡 inrtnws 

tie I nffsr ! r j..« 1 ^ 

pyq-fune - mix^r 


app * Tfc(> 

rapji ^ t i 1 1 in I " Kr ^ rl K'i r-it li J 
app t Lry f J 2 ^C»ji 1 flfl_2DO^lOO 


a-ound £llc 


H KtiU HcphlUSLLZCr-WiSV 


mljcer ■ pygjLmc« 
mixer.initI| 


■ mujcQfL 



Head First Mix 


t rack__toqqIe| || i 

laiy. y eiIi ( \ 

tracX.play{loapa 

岭 ] i 严： 

Lxiicry.^ 3 Lop( } 


trucK - ESiixer.I>aund^DQund lilcj 

一丄寫 ) 

fcrARk huttfin -» Uhi s ； f*)chi'uI:i| PP F vjirinbln — trjifiJr playing, 

connnBi：nd ― tjc-ack toqqlc, 
tieKt » B>Qund_£iliB _ 

tFQCK^&UttOrii pa€ii { Jl 
del splLLLtdawiail } i 

trac Hl . Btop{ 
app.destroy [) 

■pp * proLucpif "HH_DEL?TE_HISDC«* ^ shyLdowii | 
app.mainlcop^] 


Creating the program bit by bit is working out. Each time 
your DJ friend needs something new, you incrementally 
improve the program in order to provide the functionalilty 
he needs. Of course, there’s always something new. 

Will this guy ever be satisfied?!? 



Sy/cc 七 ! To(\(\lc s ⑽ d 



ov\ ay\d ^ W Slw ?hf 

c\\t\C\^ ov\ *tv^c ^ctkboy.. 
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add a slider 


Pump up the volume! 


To make the program more useful, the DJ wants to be able to dynamically 
and interactively control the volume of the track as it plays. Basically, as the 
track plays, the DJ wants to fiddle with the volume. 






rjf:r 


In the physical world, most devices 
that have a volume control provide 
either a large, circular knob or 
a slider on a scale: 


( 1^； 


look tw»s, 

W 一 d W 

p v^Vvt (va\>) … 

Because a slider is much easier to manipulate with a click and drag of a 
mouse than a knob, the slider on a scale is used in lots of modern GUIs. It’s the 
classic choice for showing a volume control. 


TV^C tor\bro\ 你 

a s\\Acr 

(dow ) 七 





… olr to^br 0 \ 
^'3^ look like ihis. 
H up {o 
dowh io 


Look closely at the slider. What do you need to model? 
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graphical interface elements 


Model a slider on a scale 

There’s quite a bit going on with a slider on a scale. It’s a simple control that 
everyone’s familiar with, but the simplicity masks quite a bit of complexity. 
The devil is most definitely in the details: 


七 he 

o( a 

slides ov\ a sdale ihai wc 

dll k^ow dirtd love. 



TW»s tV>c stale 

w avks a LOW 


d bundV^ mavkmjs i\\t 

stale you av-c. 



TW»s cv>d tV>c stale 
w avks a vaWc- 


T L h ^ c is 〜 sor^cihiM 

t , 7 ou 

ahd slide w Ic-fi -to 


Sharpen your pencil 


you\r *Pou\r 3hsy/c\rs licv*C- 


Look at the volume control shown above and identify four key 
characteristics of the volume control. 



2 . 


3. 


4. 
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sound before beauty 


rpen your pencil_ 

Solution You were to look at the volume control on the previous page and 

identify four key characteristics of the volume control. 

i There’s a sdale joes -fv-om a low value bo a hijh value- 

2. The sdale has a -fi^cd srt of *m*tcv-vals. 

3. T.^?. -from lc-f*t bo rijh 七 . 

4 Movir^ *the w slidev” dyhai^idallY adjusts *the volume based OY\ iis durrerrt 

fosi*tioh oy \ sddle* 


Start with the volume 

Before you start worrying about creating the appropriate GUI interface 
element to actually model the slider, you first need to know how to adjust the 
volume of a track. 

Once you know how to adjust the volume, you can then start to worry 
about linking the volume to the slider, with the current position of the slider 
dictating the current volume setting. 

Then you can allow your user to move the slider which has the effect of 
dynamically and interactively adjusting the volume. 

Sounds easy, eh? 
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graphical interface elements 


Use pygame to set the volume 


Turns out pygame has this functionality built right into its library code via the 
set—volume () method. 

Take a look at this small example program: 


import pygame.mixer 
from time import sleep 

mixer = pygame.mixer 
mixer.init () 

track = mixer.Sound("50459_M_RED_Nephlimizer.wav") 
print("Play it LOUD, man!") 
track.play(loops = -1) 
track.set_volume(0 
sleep (2) 

print("Softly does it ... 
track.set_volume(0.1) ( 一 Sc*t Volume *to 

sleep(2) 
track.stop () 





七七 ^ volume -to a LOUD 
• 9 ) < settihg. 


vcv"Y low 




FI 


Loudeir, dude, lou(W 


\ 

Tu 作 'ratke-b doW 


When you set the track’s volume to a high value using set—volume () ， it’s 
the equivalent of cranking up the volume by moving the slider to the right. When 
you set it to a low value, that’s like moving the slider to the left. 
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create the slider 


Use tkiwtcr for evcrythlwg else 

The tkinter library has a graphical interface element called Scale that lives 
to help you create a slider. Take a look at this example code and let’s see how 
it works: 


Cv-caic a tkm-tcv- Doublcl/av- variable- Like 
l>vt\/a\r and the Doublcl/av- variable 

stores a value, this a -floaty 


TV^c -tkm-bev Stale 
W»dy*b 伙 ca 七 cs a 
sl'idcv-. 


volume = DoubleVar() 
volume_scale — Scale (app, ^ 

variable 
f rom_ 
to 

resolution 
command 
label 
orient 

volume scale.pack(side = RIGHT) 


TV^c sl'idcv- tav\ be \\rktd 
•to avariable- 


Spcdi-fy -the lowest airtd 
ihc HIGHEST values ov\ 
the stale. 

Provide a ir>*idC, humair>- 
-fv'ic^dly label -fov -the 
slidcv-. 



resolution valuC) 
wWiA md^a-tes 
m*tcv"val. 


CoKmedi the 

wi dgc-t -to ah 

CVCh "t h^hdlev*. 



Clidk 5hd 
the slides -to 
adjust -the volume. 


|r\dita*tc y/V^c-t^cv- *tV^c slider 
rur\s atv-oss s£rce 灼 

(ttORlZOKTAL) or up 
screen (VERTICAL). 




The Scale () element is your most complex tkinter widget yet. But, despite 
this, it is not hard to work out what’s going on here. The graphical interface 
element is linked to a tkinter DoubleVar (called variable), the lowest/ 
highest slider values are provided (to and from 」， and an interval between 
them (resolution) is specified. The event handler is assocated with an 
event handler (command), a descriptive label is supplied (label), and, finally, 
the orientiation of the slider is specified (orient). There’s a lot going on 
here, but none of it is that hard to understand. 
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graphical interface elements 


tKereiare no o 

Dumb Questi9ns 


The Scale() code on the previous 
page has a variable called from」that is, 
the word “from” together with a trailing 
underscore. Was that a typo? 

No, it wasn’t a tyop, eh, typo. The 
reason for the underscore has to do 
with the fact that Python uses “from” as 
a reserved word. These are words that 
Python uses for its own special purposes, 
which means you cannot name one of your 
variables after a reserved word. As using 
the word “from” makes a lot of sense when 
taking about a scale, the authors of tkinter 
decided to tack on the underscore so that 
the meaning of the variable would be clear, 
while allowing for the variable name not to 
clash with a reserved word. 

Are there other reserved words? 

Yes, a few. And every programming 
language has its own list. In Python, words 
like “while” ， “for” ， “if ，， “def” ， “class”，and 
“pass” are all reserved words. 

What happens if I use one 
anyway? 

Python will most likely complain with 
a syntax error. 

Where can I find a list? 

Any good Python reference book 
will contain a list, and it’s also included as 
part of the Python documentation that’s 
installed with Python on your computer and 
available on the web at the main Python 
website. 


How do I know which graphical 
interface element to use and when? 

This is really a matter of experience. 
However, a lot of platforms go to great 
lengths to specify exactly when each of 
the elements should be used and for what 
purpose. Of them all, the Macintosh is the 
leader of the pack. Apple's engineers have 
worked hard to strictly enforce consistent 
usage of the Mac GUI among programmers. 

So, it’s a case of anything goes 
with the other operating systems? 

No. That’s not what we are saying. 

The Apple folks are very strict with their 
rules and regulations, and the others are 
less so. But there are still standards that 
you should try as much as possible to 
adhere to. One of the reasons for using 
a GUI is that your users will expect your 
program to work in a standard way. This 
makes your program immediately familiar 
to new users and lets them become 
productive with your program more quickly. 

So there are no badly designed 
GUI apps? 

No. There are plenty of howlers out 
there... and they tend to be harder to use 
than necessary, due to the fact that the 
programmers responsible for creating them 
did not conform to established interface 
standards and practices. When it comes 
to GUI programs, conformance is a good 
thing. 


So does tkinter work well on all 
platforms? 

The latest version of tkinter (which 
comes with Python 3) is pretty good. If 
you run your tkinter program on a Mac, it 
looks like a Mac OS X program, whereas 
on Windows it looks like a Windows 
application, and on Linux it takes on the 
look and feel of the graphical environment 
you happen to be using (there are a few 
choices on Linux). 

Other than tkinter, what other 
graphical toolkits does Python support, 
and should I learn any of them? 

Python supports lots of other toolkits 
on lots of operating systems. For now, 
tkinter is all you really need, and you 
shouldn’t worry about the other choices 
until you are in a situation where learning 
how to use them becomes a necessity. 
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control the volume 



ExgrciSg 


Take the pygame and tkinter code and combine it to support a volume control. Then, complete 
the next version of your program. 


from tkinter import * 
import pygame.mixer 
app — Tk() 

app.title("Head First Mix") 
app.geometry('250x100+200+100') 


sound file = "50459 M RED Nephlimizer.wav" 


mixer = pygame.mixer 
mixer.init() 


def track_toggle() : 

if track_playing.get() == 1 : 

track.play(loops = -1) 
else : 

track.stop() 


Add d 

"to adjus 七七 he volume 



dumpily plays at. 
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graphical interface elements 


track = mixer.Sound(sound file) 
track_playing = IntVar() 

track—button = Checkbutton(app, variable = track—playing, 

command = track_toggle, 
text = sound file) 

track button.pack(side = LEFT) 


Add todc 
七 V>e volume 

C.ov>tvol 


def shutdown() : 
track.stop() 
app.destroy() 

app.protocol (’ ’WM—DELETE—WINDOW", shutdown) 
app.mainloop() 
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volume controlled 



jtprt 茛 ExeRaSe 
Solution 


You were to take the pygame and tkinter code and combine it to support a volume control, 
then complete the next version of your program. 


from tkinter import * 
import pygame.mixer 
app — Tk() 

app.title("Head First Mix") 
app.qcomcLr y ( 1 250^100l 

TV^'mJs arc to 一 ^ 7 

yt Crowded oy\ 今 W |， 


so lets V^avc *bk'm*tc\r 
au-tomat^allY dtc\dt 
oy\ yomc-bvy (o’ 
us. Remove iff.. 

^to^tbr^O ，> tall -fvom i\\C 

dodic- 


sound file 


50459 M RED Nephlimizer.wav' 


mixer = pygame.mixer 
mixer.init () 


def track_toggle() : 

if track_playing.get() == 1 : 

track.play(loops = -1) 
else : 

track.stop() 


Pu-t the 

pyjarwc 匕 ode . 

dc-f volumc(v )： 

*tv*cl6k.sc-t_volumcf volume.ytO) 
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put tkmW 

Codt V>cvc- 


track = mixer.Sound(sound file) 
track_playing = IntVar() 

track—button = Checkbutton(app, variable = track_playing, 

command = track—toggle, 
text = sound file) 

track button.pack(side = LEFT) 


volume Poublc\/olv*0 

volumc.sc*tf*tv-adk.^c*t_volumc0) 

volume 一 sdale 二 Sdalcfvaviablc 二 volume, 

*(*\roinrt ■ O.O, 

*to 二 IA 

resolution 二 

label 二 'Volume 

OV-iCht 二護 U 

volumc_sdalc.padk(sidc =■ Rl^ttT) 


def shutdown() : 
track.stop() 
app.destroy() 

app.protocol (’ ’WM—DELETE—WINDOW", shutdown) 
app.mainloop() 
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test drive 




Tesr DriVq 


Let’s take the latest version of the program for a spin in IDLE. In addition 
to turning the sound on and off with the checkbox, you should be able to 
dynamically and interactively adjust the volume with the slider. 



.py w - /hem e/b«rry p/Head F ir^tProg i'eh ■ 


fik* E: 邮 Fyr niaL Run ( Q^iiiuti!i W-indyw^ 

Lk.inL 

T - pyy 

app * TJt (( 

app. title [ n iJcad IMrat JiiK'J 

nauriil f 11« — H 41!l HHITi ph ! t r ; . li'A-v " 


muxT 
mi ner 


■ pyq-anie 1 


;T ： ra€Jt_tQggle< >s 

■ trocK_pliiy±Eig. gcc {) 
t racK ^ play ^1oapa ■ 



chH/3*ge_vu lume 1 ( v } i 

t_,E . sff L__v1j 1 LLme t WOl 

t rack - nixer ■ Sound H b Dund_£ll«i \ 
tracfcjploying - IntVar ；) 
trac3fc_inatton - variable ■_ t r&c K_pIoy ing, 

^mnmjind -■ trisifk tinggli 

Lf ojcV IhjL tun . a-itlc 


vultuma ~ Dvub LeiVai. j ) 

voluna.a«t(tracK.gat_voluma {\\ 

volu5M_aco lc _ Gcal e f varialylc 

Iram_ 

f:n- 

mno^S .1] t: i o:n 
crcunnuiTid 
lalxl 
urlenL 

VOlUTr€_HCA , DACH ^ H n AIGUT ) 

: C t 3hl3&fjDVn( > i 

tEacX.stapd 
,npp. dr.fi hrny | J 


It works. Not only can you 
start and stop the track, 
but you can now adjust the 
volume, too! And all from 
the one GUI... sweet! 
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graphical interface elements 


The W is over the moon! 


Your code has shown the DJ that his idea for the Ultimate Music 
Mixing program is not as far-fetched as everyone once thought. With 
his idea, talent, good looks, and — above all else — modesty, together with 
your coding skills, the world’s the limit for what you can accomplish 
together. The World Music Mixing Expo is next month, and the DJ 
can’t wait to show off your completed software. 





Wow! This is really 
fabulous... I can now start 
converting all my vinyl tracks 
and, thanks to your program, 
my laptop is on its way to 
being my music mixing desk! 




J33 / 
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programming toolbox 



Your Programming Toolbox 

You’ve got Chapter 9 under your belt. 
Let’s look back at what you’ve learned 
in this chapter: 


〜哼 rsJ : 二一一 4k1 
二 r 。一一， 

工％ ::二:二 ㈣ 二一： 

㈣ .〆- 一、 


Tods 

:‘3如‘/铷‘，心 
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ONSPH.S 


10 custoni Widgets and classes 


f With an object in mind ♦ 



Requirements can be complex, but programs don’t have to be. 

By using object orientation, you can give your programs great power without writing lots 
of extra code. Keep reading, and you’ll create custom widgets that do exactly what you 
want and give you the power to take your programming skills to the next level. 


this is a new chapter 
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mixing multiple tracks 


The PJ wawts to play more thaw one track 


The World Music Mixing Expo is only a few weeks away. Your DJ friend is 
thrilled with the work you’ve done, but now he has a few extra requirements. 

Just playing one track isn’t enough. To be useful, the program needs to be able 
to mix several tracks together at the same time. Each track needs its own 
graphical interface elements (or widgets). 


I can fade a track 
in and out, but thafs 
not enough. I need to 
be able to mix several 
tracks together. 


How will you create the widgets for each track? 

To play and control a single track, you created two widgets on the GUI: a 
check button to start and stop the track and a scale to change the volume. Then 
you added event-handling code to hook those widgets up to the sound 
system. 


Tu\rh 


Tvatk- 


Oh/o-p-p. 



Covrbrol 七 he 
volume- 



To play multiple tracks together, you just need more of the same. Each track will 
need its own set of widgets and its own event handlers to connect the widgets and 
the track together. Then, each set of widgets needs to be added to the same 
window in the GUI. 

Let’s generate the widgets and event handlers. 
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custom widgets and classes 


Create code for each track as a fuwctiow 

You could just copy and paste the code several times for each track. But 
duplicated code is a bad idea, because it can lead to all sorts of problems 
whenever you need to change how the code for each track works. Instead of 
duplicating code, you should always try to reuse it. 

One way to reuse code is by creating a function that will generate the widgets 
and the event handlers as needed. 



as needed- 



If you have a function that creates the widgets and event handlers for a single 
track, you could call it for each of the tracks, which would then quickly let you 
build the entire interface. 


But what code would you need in such a function? 
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new function 



fjont ExeRdSc 


Here is the code from the end of the previous chapter. Study it carefully, and then, in the 
space on the next page, write the code for your new function (based on the code below). 


from tkinter import * 
import pygame.mixer 


Bcj'm by 'imfovt'mj i\\t 
libraries you need. 


app = Tk() 


Create <^U| afflidatio^. 


app.title("Head First Mix") 

sound file = "50459 M RED Nephlimizer.wav 〗 


mixer = pygame.mixer 
mixer.init () 


...ahd ihiii^liz^ 
So ^d system. 


def track—toggle(): 

if track_playing.get() == 1 : 

track.play (loops = -1) \ 

else: detail v/Via-t 4 ⑼ a 於 

track. stop () cvcir\*t ofi.tu\rs. 


def change_volume(v) : 

track.set volume(volume.get() 


Pc-f'mc 乩私 kbo% w 却 t. 

/ 


track = mixer•Sound(sound—file) 
track—playing = 工 ntVar() 
track—button = Checkbutton(app, variable = track—playing, 

command = track—toggle, text 
track—button•pack(side = LEFT) 
volume = DoubleVar() 
volume.set(track.get_volume()) 
volume scale = Scale(variable 


sound file) 



Pc-P'mc sl'idcv- Widjct 


command = 

volume scale.pack(side = RIGHT) 


volume, from— 
change volume 


0.0, to = 1.0, resolution = 0.1,- 
label ="Volume " r orient = HORIZONTAL) 


def shutdown() : 


"V 


track.stop() 
app.destroy() 


hhdle a diek 0h 

dlosc box. 


app . protocol ( n WM_DELETE—WINDOW’ ，， shutdown) 

aPP •皿 nl °° P ()A S WU^v^loof. 


352 Chapter 10 







custom widgets and classes 


you are here ► 


353 




























function created 



fpt\% ExGRciSe 

^goLutlOH 


Here is the code from the end of the previous chapter. You were to study it carefully, and then, 
in the space on the next page, write the code for your new function (based on the code below). 


from tkinter import 
import pygame.mixer 


app = Tk() 

app.title("Head First Mix") 

sound 一 file = "50459_M_RED_Nephlimizer.wav" 

mixer = pygame.mixer 

mixer.init() 

def track—toggle(): 

if track_playing.get() == 1 : 

track.play(loops = -1) 
else : 

track.stop() 

def change_volume(v) : 

track.set_volume(volume.get()) 

track = mixer•Sound(sound—file) 
track_playing = 工 ntVar() 

track—button = Checkbutton(app, variable = track—playing, 

command = track—toggle, text = sound—file) 
track—button•pack(side = LEFT) 
volume = DoubleVar() 
volume.set(track.get_volume()) 

volume_scale = Scale (variable = volume, from— = 0.0, to = 1.0, resolution = 0.1,- 

command =change_volume , label = "Volume ", orient = HORIZONTAL) 

volume_scale.pack(side = RIGHT) 

def shutdown() : 
track.stop() 
app.destroy() 

app . protocol ( n WM—DELETE—WINDOW' ，， shutdown) 
app.mainloop() 
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f egih by —oirti% -fv'prn *(;kih^cr import ^. 

the lib\rd\ries you 

-to use ih -this . py^a^c . 

module. 

’ dc-f d\rc3*tc^uifapp, mi>cc\r, soundjfile): 

Cv-ca*tc a \\AY\tt\oY\ ^ . — . _ . 

七 V^a*b dor\ta'ms i\\t ^W|- /dc-f *t\radk_-to^lcO ： 

d\rca*tm5 CoAt -from {\\t / p 

tuV"V"Cy\*t fv-oydm- j •士 *tv*3dk___ 七 (） 二二 I: 

-tradk playOoops 二 - 1) 
else: 



*t\radks*topO 


dc-f dha^c^volumcfv )： 


*t\radksc*t_volumc(volumC5C*tO) 


: bc 3 焱 k.; . 一， ( 柳 o.d .^i!c.) 


All o( -this Code is pa^-t 

-the -Puh^-tioh, SO ii . 

wds be ihdehted. … "七 >：a 少』 


七 X—pp.,. .i^dpbyin 

dommdhd — *tv"3dk^*to^l t) 

七以七二 souhd 」 ile) 

七 radk 一 lou 七 Wj>adk(side 二 LEFT) 
volume 二 Pouklc\/av-0 


volumCSC*tf*t\radk .^c*t_volumcO) 
volume stale 二 £dale(\/ariable = 


volume, -f\rom 二 O Of *to 二 10, 


resolution — O.l, dommdhd ^ volume, 

label 二 Volume^, orieh 七二 HORIZONTAL) 


volumc^sdalcpadkfsidc =• Rl^ttT) 
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function in a function 


The new fuwctiow contains other fuwetiows 


With all the code gathered together in a new function, the code for the 
create gui () function looks like this: 


This -Puh^tioh is 

( l ocal h> the 

-Puh^-tioh. 


TWis “tW、 s 
LOCAL.) 仫 0 — ^ 


from tkinter import 
import pygame 

def create_gui(app, mixer, sound—file): 
def track—toggle(): 

if track_playing.get ()== 
track.play(loops = -1) 
else : 

track.stop() 




州心 this 
"Puh^-tioh is 

^llcd, ii s-bv-ts 

-Pv-orh 

hc\rc. 


TV^csc avc 州乇 


def change_volume(v) : 

track.set volume(volume.get()) 


tails to 
、 a6k()” add 
i\\t *to 

七 V\e 今 ⑷. 



track = mixer•Sound(sound—file) 
track playing = 工 ntVar() 

t r ac k ：button = Chec k button(app, vanabk = track— playi ng, 

command = track toggle, text 
track_button.pack(side = LEFT) 
volume = DoubleVar() 
volume.set(track.get volume()) 

VOlume _ SCale = ScaleTva ri able = volume, from. = 0.0, to = 

resolution = 0.1, command = change_volume , 
label = ’'Volume'', orient = HORIZONTAL) 
volume scale.pack(side = RIGHT) 


Do you notice anything strange? The new function actually has two other 
functions inside it. Python (and several languages) lets you create local 
functions. A localfunction is just a function inside a function. 

Let’s see why they’re important for the DJ’s program. 


A function-in-a- 
f unction is callect 
a local function. 
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custom widgets and classes 


Your wew fuwctiow needs to create widgets 
awd evcwt handlers 

When you’re wiring up the widgets in the interface, you need event handlers 
to respond to changes in the state of the widgets. If someone clicks the 
checkbox to play the track, the track—toggle () event handler gets called 
and switches the track on or off. 

But if you are creating several checkoxes, you are going to need a separate event 
handler for each of them. 

That’s why you have localfunctions inside create—gui () . As well as creating 
new widgets for the interface, it also uses the local functions to create new 
event handlers. 


Eack wictgfet 
needs its own 
event kanctler. 



create 一 〜() 


0 一 〆 

This is S hew 

Chc^kbu't'fcoh. 


■brM 一 — 3 |〆) 、 


TWis a ^ ^ 


volumcO 

〆 一 


TWis IS a r\C*i 


Now, let’s update the program to use this new function. 
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localize functionality 


Functions inside of functions inside 
of functions inside of functions... 
now, thafs what I call complexity. Of 
course, everythings local, you know. 


o 



Frank: A function inside a function? Surely that’s not legal? 

Jim: Well... it depends on the programming language. 

Joe: Don’t tell me this is something that only works with Python?!? 

Jim: No... there are lots of programming languages that allow you 
to put a function inside another function. 

Frank: Name one (other than Python)! 

Jim: Pascal. 

Frank: Pasc." what?!? 

Jim: Look, it really doesn’t matter which programming language 
supports this feature. What is important is that we can do it. 

Frank: And by “we” you mean “Python.” 

Jim: OK, yes. Python can do it. 

Frank: That’s all I was trying to say... 

Joe: So, this is cool how? 

Jim: Because it lets you localize functionality and handle complexity. 
Joe: What?!? 

Jim: Look: if a function gets big and complex, it can help to break 
the function down into a collection of smaller functions, just like we 
do when programs get big. We can keep the functionality local to the 
code that needs it inside the function. That way, we keep things as 
simple as we can 

Joe: Even if the code itself is complex? 

Frank: Like the GUI-building code we are working on now? 

Jim: Yes. 

Frank: OK. A function of functions it is, then. I’m all for keeping it 
simple, stupid.;-) 

Joe: Yes, I like KISS, too. 

Jim: Yeah... their last album was really something special, wasn’t it? 

Frank & Joe: Eh?!? 
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Begin by putting the create—gui () function in a separate module called sound—panel • 
py. Then, write a new version of the hfmix. pyw program that uses the sound 一 panel • py 
module: 

lA/vi*be youv- Codt here. 
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sound panel 



ExesciSe 

SotuiiOH 


You were asked to begin by putting the create—gui () function in a separate module called 
sound_panel. py. Then, you were to write a new version of the hfmix. pyw program that 
uses the sound panel. py module: 


/^poirt all -the 
»Uhd*tiohS 

hew module. 


-fvom —for 七决 

import py<jai^C.mi>cc\r 


aj>d 

app.*ti*tle( u Wead First Mi%”) 


nr\iy.cv.*mi*tO 


By v\t^i 产 . 

TlA/IC 它， 

ertait TWO sets …- 




sour\d 6 or\*tv-ols ov\ 


dc-f shu 七 dovmO: 


app.dcs*t\roy() 


cipj>•.p^oto^ol ( 'W QY/!.i shutdown) 
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custom widgets and classes 


DriV0 


With the code typed into IDLE, take this latest version of the DJ’s program 
for a quick spin by pressing F5. 


These dhcdk buttohs 
s-fcop 

o( the tvadb. 





Head First Mix 



/I/ 


Volume Volume 

50459_M_RED_NephIimizer.w bv 1^ 49119_M_RED_HardBouncer.wav 0.1 0.9 











TV^csc sidles dor\*tv-ol 
*tV)C volume- 


The program has created a checkbox and a volume slider for each track. 
The program called the create—gui () function twice, creating two sets 
of widgets. Of course, you can call it as many times as you like and the 
create_gui () function will create the two widgets for each track. 

When you click on the two checkboxes, the two tracks both play at the 
same time'. You can start and stop each of them independently by selecting 
and deselecting the checkboxes. But more than that, the volume sliders 
independently change the volume of the tracks, allowing you to mix them 
together. 

This is a big deal. The create—gui () function is not only creating the 
separate widgets and adding them to the interface, but it is also creating the 
event handlers that allow each pair of widgets to control each separate track. 
Here the program is controlling just two tracks, but if you added more calls 
to create_gui() in the code, there’s no reason why you couldn’t get the 
interface to work with as many tracks as you like. 


Let’s see what the DJ thinks. 
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confusing interface 


The W is confused 

The program does exactly what the DJ wants, right? Well, not quite. 


How am I supposed to 
know which volume scale 
is for which track? 


O 


0 


The problem is that even though the program technically works, it has 
a confusing interface. All of the checkboxes are added on the left of 
the interface, and all of the volume controls are on the right. 

There’s nothing in the interface that indicates which volume scale 
goes with which track. 


Head First Mix 
















Volume 

1^ 50459_M_RED_NephIimizer.wav 1^ 49il9_M_RED_HardBouncer.wav 0.1 


Volume 


0.9 


T\radc 养 1 0 \r 养 Z? 


Tvatk or *tv-adk ^1? 


The checkboxes are labeled with the filename of the track, but the 
volume sliders aren’t. Even though each volume slider is linked to a 
single track, there is nothing in the interface that tells the user which 
track that is. 

So... what to do? You could add labels to each volume slider. 

That would probably fix it, but adding more widgets, like labels, can 
make an interface more complex. And you want your interfaces (and 
your GUI code) to be simple and clean. 

Fortunately, there is a way of rearranging the widgets in the interface 
to make it a lot clearer. 


"fo avoid doyvfusioh 
i\\c 6 \U\ bo look 

like 七 his. 
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custom widgets and classes 


ftroup widgets together 

If the interface were laid out with the checkbox for a track grouped 
alongside the volume slider for the same track, it would look better. 

Each track could then have a row of widgets associated with it. As long as you 
know which widgets belong to which track, you can load a lot more tracks at 
once without the checkboxes and sliders getting separated (and without your 
users getting confused). 

The program currently uses a function to add the checkboxes and sliders to 
the interface one widget at a time. If you call the function several times, the 
computer creates two more widgets with each call. But the widgets are not 
grouped. So, how do you group widgets together in a GUI interface? 

Create a new type of widget 

What if you donH^u^t hand the computer a set of instructions? What if you 
give it a brand new widget instead? 

If you create a new kind of widget that groups a checkbox with a slider, 
you can add your new widget to the interface and then guarantee that the 
checkbox and slider stay together: 



O 



The ^U| 
padkev- 



必 umB_ 

r 

1 


— l 

wmmmKmmmmmmmmmmmmmmmmmmmmmmmmmm 

TtrJTtmilK'-- 

. ■ 

■ 

\*olume 



r 

1 n 二 

I 



i,a, 


Youv y\C*i 

so always 

stay 



Your new widget becomes a new building block for your GUI interface. 


So, how are new widgets created? And how do they work? 
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frame widgets 


A frame widget contains other widgets 


Most GUI libraries (including tkinter) let you create custom widgets from a 
set of other components, and tkinter includes a special kind of widget called 
a frame. A frame works just like a picture frame, in that it surrounds other 
things. It’s rectangular and it can contain other widgets: 


a -fvawc- 



In tkinter, a frame is created using Frame () . If you can work out a way to 
create a new type of frame (called, say, SoundPanel) that contains the checkbox 
and the slider, then you could use code something like this in your program: 


Create a hew 
SouhdRahd 
widget. 


These av-c i\\t same favamc*tcvs you 
passed *to 



> u t^v\ add youv- Vidjc-t *to 
^U| us'm^ *tV^c > just 1’ke 
all o-tV^cv- widyb. 


t 


This look like a great solution. However, you still have a big problem. 



Da fMs! 


Even though you 
haven’t created the 
SoundPanel code 
yet, let’s replace the 
calls to create 一 
gui () in hfmix. 
pyw with these lines of 
code now. Just don’t try 
to run it yet. 


This code uses an entirely new type of object, a whole new kind of 
widget that has never existed before. How do you tell the computer to create 
something like that, which is effectively a custom GUI object? 


How do you convince the computer to create a new 
widget each time you call SoundPanel()? 
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custom widgets and classes 



WouldtVt it be dreamy if there 
were a way in code to create an 
entirely new kind of widget. But 
I know \Ys just a fantasy... 


m 
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programming class 


A class is a machine for creating objects 

Object oriented programming (OOP) languages (like Python) let you create 
an entirely new kind of object using a class. A class is like a template that you 
use to create new objects. 

Think of the class like a cookie-cutter, and think of the object as the cookie 
that is created based on the class. As all the cookies are created from the same 
cookie cutter, they all have the same characteristics, even though they are 
all individual cookies. When an individual object is created from a class, it’s 
referred to as an instance of that class. 

So, if you can arrange for SoundPanel () to be a class, you can create 
custom widgets as required: 



SoundPanel 



a hC w 

o^dPa^K) 


ne 品 n, 









You need code that creates a new grouped widget in the GUI every time you 
make a call like this: 

Use tlass {jo Credit d ^ object 

panel = SoundPanel(app, mixer, "49119_M_RED_HardBouncer.wav") 


Let’s define a SoundPanelQ class. 
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custom widgets and classes 


A class has methods that define behavior 


The SoundPanel () class creates a new kind of tkinter Frame (), and you 
can specify this relationship using the code like this: 丁 


This says lhal wc av-c 
dc-Pih'mg a hew CLASS_^ 



class SoundPanel(Frame 


l^didaic that ihe 
^lass is a type of 




nc METttOPs tV^c tlass 30 
TV^ vaord w mc*t^od w is used m OOP 
ms-tcad {\\t >wo\rd w -fuy\£.*tior\. 


As well as the what (it’s a frame), you also have to worry about the how, which 
will define the behavior of your new widgets. To do this, you need to add 
methods inside the class. To understand how this works, imagine you have 
created an alarm button object from a class. The alarm button will need to 
know what to do when somebody hits it: 



This will be a method 
… side the a\a^ 
button’s dlass. 


Sharpen your pencil 


The method -tells i\\t button \\ovj *to 
bekdve >whcir> 




You need to create some methods for the new SoundPanel () 
class. Which of the following behaviors do you think you need to 
create methods for? Draw a circle around each one: 


Someone moves the volume slider. 


Someone clicks the checkbox. 


The computer starts up. You get to the end of the track. 


Create the interface. 
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necessary methods 


«^harp€n your pencil 
< Solution 



You needed to create some methods for the new SoundPanel () 
class. You were asked to identify which of the following behaviors you 
thought you needed to create methods for: 

You vc alveadY trcaitd 
hav>dlcv-s 七 ha 七 
do some 七 iVmg like 



The computer starts up. 


You get to the end of the track. 


广 一 ^ do you heed 

(Create the interface. ) "to do *to 

、 - the ihtcir-Padc? 


thereicire no o 

Dumb Questi9ns 


Why is there a method to create the widget? 

There isn’t a method to create the widget. But there is a 
method to create the interface. That method will run immediately 
after the widget is created. 

I don’t get it. What’s the difference between a widget 
and an object? 

A widget is a particular type of object. It's an object that you 
can add to a graphical user interface. 

So there are some objects that are not widgets? 

Absolutely. Most objects are used behind the scenes in 
programs. All of the numbers and strings you’ve used so far have 
actually been objects. 


So you can’t always see objects on the screen then? 

No, most objects run quietly in memory and they don’t have 
any display at all. 

Is Python the only object oriented language? 

Lots of languages—such as Java, C#, and Ruby—use 
objects to handle complexity. 

So learning object orientation is a good way of getting 
into other languages? 

Yes, understanding object orientation gives you a insight into 
how other languages think. 
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custom widgets and classes 


Put how does an object call a method? 

To see in more detail how the new SoundPanel widgets use the methods in 
the SoundPanel class, let’s look in more detail at just one of the methods. 
What happens if someone clicks on the checkbox within the widget? 


Hey, someone clicked 
the checkbox. The event 
handler for that is called 
'track—toggle". What happens 
now, SoundPanel class? 


O 


0 







TW»S IS todt *to 
w tva6k *to 奶 kO” 


The method takes a 
^_single fa\ra^ctcv. 




def track—toggle (self): 

if self .track playing.get() == 1 
self. M . pl a y(1 oops = -1) 
else : 

self .track.stop() 


The method you need to add to your class should look familiar. This code 
is almost the same as the track—toggle () event handler we created 
before. The only difference is that this method is a little more selfish. 


idchti-fics the 

widget 亡 alii% the 

method- 


se|f identifies the widget calling the method 

The methods in the class are going to be used for lots of objects, so the code 
in the class needs some way to know which SoundPanel object it is working 
with at any point in time. It does that with the self variable. 

The self variable is passed to each of the methods in the class automatically 
by Python and it identifies the current widget object being used. By adding 
“self • to the front of the object’s variable names in the class code, you 
make sure the code is using the data that belongs to the current widget. 


Let’s add some methods to the SoundPanelQ class... 


you are here ► 


369 





class replaces function 


The SouwdPawel class looks a lot like the 
crGatcjguiO fuwctiow 

If you convert the original change—volume () function to a method and 
add it to the class, you end up with code that looks rather like the original 
create gui () function: 



In fact, the new SoundPanel () class can completely replace the code in 
the sound_panel. py file (as create—gui () is no longer needed). 

But before you do that, there’s still a little more code to write. The class needs 
to be told what to do when the brand new SoundPanel () is created. The 
class needs an initializer method that knows how to create instances of the 
class. 

Some p'rogirammihg Uhguagcs dal I these 
mitialiw methods CONSTRUCTORS, bc^usc 
七 hey detail what happens whch a hew ob\cdt 
is seated o, J 


Let’s create the initializer for the SoundPanelQ class. 
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custom widgets and classes 



Code Magnets 

WeVe started to create the initializer code for you, but there are still a few 
parts missing. See if you can work out where the missing code fragments 
fit. Here is the code that creates a SoundPanel () object. Position the 
code magnets properly to complete the method: 


def _init_(self, app, mixer, sound—file): 

Frame _init_(self, app) 

卜 、 n Because WdPa^clO 

you *to be suv-c 

{p •m.t.al.z.c Pv-amcO BEFORE you 

m'ltializjC Sou\r\dPay\clO. 

track—button = Checkbutton( , variable = , 

command = self•track—toggle, text = sound—file) 

track—button•pack(side = LEFT) 

self.volume.set(track.get_volume()) 

volume_scale = Scale ( , variable = self.volume A from— =0.0, to = 1.0, 

resolution = 0.1, command = , 

label = "Volume ", orient = HORIZONTAL) 
volume_scale.pack(side = RIGHT) 
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initializer constructed 



Code Magnets Solution 


We’ve started to create the initializer code for you, but there are still a few 
parts missing. See if you can work out where the missing code fragments 
fit. Here is the code that creates a SoundPanel () object. You were 
asked to position the code magnets properly to complete the method: 


def init (self, app, mixer, sound file) : 


丁 & 七 ， s a Frame . — init — (self, app) 


/ 


Sou\r\dPay\clO 

object V^as »*b ov/n tv-adk. 


\AV\dccsCort a-t 
s\dc ok , 

七 >wovd 



track = mixer.Sound(sound_file[ 


trackjplaying 


=intVar () 


track button = Checkbutton( 




杉 Sou^dp3i^cl0 object has 
ovm dhcdkbo^. 



variable 


command = self.track toggle, text = sound file) 


track button.pack(side = LEFT) 



self.volume.set(track.get_volume()) 

volume scale = Scale ( | self I , variable = self•volume, from =0.0, to 


taAS ⑽ dPav^ 0 

object V>as sUdcr. 


/ 


[ED 


.0 


resolution = 0.1, command 


[SO 


label 

volume scale.pack(side = RIGHT) 


Volume", orient = HORIZONTAL) 


class 55 methods ^ data 

The SoundPanel () class has methods that define the behavior 
that it implements. In addition to the methods, the class also 
has to detail the data that it holds. For the SoundPanel () 
class, this data is made up from three things: the track to play, 
its checkbox, and its associated slider. 
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custom widgets and classes 



The Class Expose 』 

This week’s interview: 

Life in senior object management. 


Head First ： Hello, Glass. It’s good of you to find 
the time to speak to us. 

Class： I assure you the inestimable pleasure is all 
mine. 

Head First: So, to begin... 

Class ： One moment... <hums> 

Head First: I’m sorry. What’s that? 

Class ： Apologies. Just checking my initializer. I 
always do it when I create. 

Head First: Ah, yes. That’s your constructor, isn’t 
it? The method you use to create objects? 

Class ： Well, I’m aware that some people refer to it 
as a constructor, but I prefer initializer. I don’t use 
it to create objects, you see. I just use it to configure 
them once they’ve been created. 

Head First ： You have a lot of methods? 

Class: Oh, more than you can possibly imagine. 

Head First ： In the code we’ve just seen, the 
SoundPanel () class, there were only three 
methods, weren’t there? 

Class ： Oh, dear boy, there were only three methods 
defined explicitly in the class. But SoundPanel () 
inherited many, many more methods from its parent 
class, dear old tkinter’s Frame (). 


Head First: Frame () has a lot of methods, too? 

Class ： Too many to discuss, really. There are 
methods to paint components on the screen and 
details of what to do if things change size. Frame 
is a fearfully busy fellow. <beep beep> Excuse me. 
Hello? Yes? No, you need to stop playing track four. 
No, no, it’s quite all right. Goodbye. 

Head First ： One of your objects? 

Class ： Yes. They keep me very busy, but I’d miss 
them if they didn’t call. 

Head First ： I believe when someone calls an object 
method, the object always asks you to get involved? 

Class ： Yes. I’m in charge of the object’s behavior. I 
do think it is so important to behave properly. Don’t 
you? 

Head First: Of course! Glass, thank you. 

Class ： Love the tie, by the way. 


you are here ► 


373 


code review 



Vy I V V-^ y 义 } 


It’s always good every once in a while to check back on the state 
of your code and make sure everything’s looking spiffy. This is 
what your program should look like at this point. It’s probably 
worth checking to make sure everything in your code looks like 
this: 


Umix.py^ 
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custom widgets and classes 


Soimd_paneI.py 


from tkinter import * 
import pygame.mixer 


Ucyt i\\t object »s treated. 


class SoundPanel(Frame) : 

def init (self, app, mixer, sound file) : 

^ me .= init —( Sel f, a PP ) _ 

self.track = mixer.Sound(sound file) 

Sel f. track _ playing = IntVarO ' 

track button = Checkbutton(self, variable = self.track playing, 

command = self.track_toggle, text = sound—file) 
track—button•pack(side = LEFT) 
self.volume = DoubleVar() 
self.volume.set(self.track.get volume()) 

VOlume _ SCale = Scale (self, variable = self.volume, frOm _=0.0, to = 1.0, 

resolution = 0 . 1 , command = self•change—volume, 
label = "Volume", orient = HORIZONTAL) 
volume scale.pack(side = RIGHT) 

defM _( self ): 

if self.track_playing.get() == 1: 

self.track.play(loops = -1) 
else : 

self.track.stop() 

def change volume(self, v) : 

self.t ； ac k .set vc^ne (seif • • get ()) 
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test drive 




Tost DriVq 


OK, so you’re finally ready to start up your new custom widget code. This 
is what it looks like after you bring your code into IDLE and press F5: 






The checkboxes and volume scales are now grouped together on the 
same widget within the GUI. From now on, you will know that the 
widgets on your GUI will always stay together as the SoundPanel () 
class has grouped them for you. 























custom widgets and classes 


tJieretare no ^ 

Dumb Questi9ns 


I don’t get it. What’s this “self” thing again? 

“self” is a variable that refers to the calling object. 

The calling object? What does that mean? 

Imagine you create a new method called bleep () in 
the SoundPanel class. An object called panel can use 
the bleep () method as needed, and when it does, it calls the 
SoundPanel class. The “self.” bit ensures that the bleep () 
method associated with the panel object is called, not some 
other bleep () method associated with some other object. 

So objects don’t actually own their own methods? 

In some languages, such as Ruby, they can, but in most 
languages, no, objects don’t own their own methods. The methods 
all belong to the class that created the object. 


But why do I need to add “self.” to the start of the 
variables? 

Because then you are changing data inside the current 
object referred to by “self.”. You will be working with the object’s 
own data, and not with data that belongs to the class. 

Not all the variables had “self.” at the beginning. Why 
is that? 

If you look at the code, the volume_scale variable 
does not begin with “self.”. That’s because the object does not 
need to keep track of the volume_scale variable once the 
initializer method has finished creating the object, volume— 
scale is a variable that is local to the initializer. 


BULLET POINTS - 

■ The SoundPanel widget is a type of frame. 

■ Objects get created by classes. 

■ A class has methods. 

■ The methods define the behavior of the 
object. 

■ When an object needs to know what to do, 
it calls a method in the class that created it. 


■ The methods in the class all have a self 
variable. 

■ The self variable points to the object 
that called the method. 

■ By prefixing variables with “self.”, you 
can keep each object's values separate 
from each other. 
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add the tracks 


The PJ has m cwtire directory of tracks 

The DJ is so impressed by how usable your program is that he wants to 
try it out tonight for his complete set, prior to its official unveiling at 
the World Music Mixing Expo. The DJ needs to work with a lot more than 
two tracks. In fact, he has an entire directory full of loops. 


Piv-ct-bov-y 
-full loops. 

SL 



5ta9@6-read-all-fi^& - Fits Manage 


B\e 运 d 比 Miew 50 htelp 


M banyp] | 口 Desktop | inPcsign HhProg chaptcriu | code | [stapee-read-al l-files 


1 戒 1 


i 

, § 0^ j 

:: 七 | 

j M¥WU 

i uinv 

ir VJWV 




19147_M_RrQ_b 

ccp_finc.wav 


IIJA 1 I 


194n4_M_PrD_ 

_tmncc_mljnpcl 

_loup.wav 


d III nil 


19fi07_M_Rrra_ 4131 ? W RFD_S 417?2_M_Rm 
_tmmpct_dcliiy_ onar_Une.wav _happy_freaq J wa 
laup.wdv v 


m 


45414_M_RED_Tt 49119_M_RED_H 5045-9_M_RE D_N 50843_M_RED_W 39264_M _RED_T 
ance_Train.wav andBouncer.wav ephJirriizer.wav 3ve8aseLoop„wva heDn^amiDmnfis„ 

v wav 


一 rim 他一 

tribute n.txt 




4 

^niinri_pnnol.piy 


13 Serins (14 5 mb), Free space： 4.7 gs 




I want to use all 
of these loops. Can 
your program add all 
of these WAV files 
to my interface? 


O 


o 


Now you could just change the code to add the extra files to the interface, 
but the DJ wants to be able to manage which tracks the program uses. 

So you will have to find all of the WAV files in the current directory and 
then add them to the interface when the program starts. 



l r> 




Let’s get this thing to work. 
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custom widgets and classes 




aa] Plizzjc 


Your job is to take segments from the 
pool and place them into the blank 
lines in the code. You may not use 
the same segment more than once, 
and you won’t need to use all the 
segments. Your goal is to complete 
the code in hfmix. pyw so that it 
reads all the tracks from the directory 
and then adds them to the GUI interface. 


from tkinter import * 
from sound—panel import * 
import pygame.mixer 
import os 

app = Tk() 

app.title("Head First Mix") 

mixer = pygame.mixer 
mixer.init() 


def shutdown() : 

track.stop() 

app.destroy() 


app.protocol( n WM—DELETE_WINDOW n , shutdown) 

Note: each thing from a PP • mainloo P () 
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tracks added 


Paa] Plizzjc 

Your job was to take segments from the 
pool and place them into the blank 
lines in the code. You could not 
use the same segment more than 
once, and you didn’t need to use 
all the segments. Your goal was to 
complete the code in hfmix. pyw 
so that it reads all the tracks from the 
directory and then adds them to the GUI 
interface. 



You {p 

so — 

\wfov-t KK os module. 


from tkinter import * 
from sound—panel import * 



import pygame.mixer 
import os 

app = Tk() 

app.title("Head First 


mixer = pygame.mixer 


Mix") 

七 oUl 

七 V>e -f iles m tuv-vcir\*b 


Take caA of 七 k 


mixer.init() 




dirList = os.listdir( 
for fname in dirList : 


d'iv-c£.*bov-Y* 


…办 d 4 •• 七⑼如 m w >/av”. 


...crea 七 e a 

Souy\dPay\el() a 扒 d add 

•rt 仏 c $Wl 


if fname.endswith( n .wav") : 

SoundPanei(app, mixer, fname) 
.pack() 

def shutdown() : 

track.stop() 

app.destroy() 


panel 

panel 


app . protocol ( n WM—DELETE—WINDOW ，，， shutdown) 
app.mainloop() 
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custom widgets and classes 



Tqst DriVQ 


With the code in IDLE and all the sound files in the directory, press 
F5. You should see something that looks a lot more powerful than 
the simple two-track mixer you had before: 


Head First Mix 


Volume 

39404_M RED_trance trumpet loop. wbv 1,0 


Volume 

^ 59264 M RED TheDreamDrums.wav 0 j6 


Volume 

5D4 59_M_RE D_Nephlim rzer.wav 1.0 


Volume 

v 49119 M RED HardSouncer,wav 0.2 


Volume 

^ 41312 M RED Sonar Lme.wav I D 



Volnmp 

4S414 M RFH Tr^nrp Train wav H.f> 


Vuluine 

3914 7_M_REO_b etfp liE i& wdv 0,6 


Volume 

396 07_M_RED_tru mp et_del ayjoop, wav 

Vnlump 

17 41 7 ?? _M_RF□_happy_f「paq wav U 


Every single track from the directory now appears on the 
interface and can be individually controlled. The program looks 
like it finally does everything the DJ wants. But the real test will be 
how it performs at World Music Mixing Expo... 
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programming rocks the house 


The mixer program brought the house down! 


The DJ took your program to the World Music Mixing Expo and rocked 
the house, with your name in lights! By using classes for the widgets and 
creating an object oriented program, you made your good program (and 
the DJ’s performance) great. 


Ifs party time! 


Object orientation is meant to help you create complex programs with 
very little code. A lot of languages use object orientation, and not just 
for graphical user interfaces. You can use objects to build web applications 
or simulators or games. Any time you need to write an advanced program 
but don’t want your code to turn into a tangled mess of spaghetti, object 
orientation can come to the rescue! 

Congratulations! 

You got to the end of the book! And what a great journey it’s been. You’ve 
ruled with control statements. You’ve powered-up your programs with 
modular code. You’ve made graphical user interfaces that sing and, finally, 
you took your coding skills to the next level with object orientation. 

Well done! 
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Your Programming Toolbox 

You’ve got Chapter 10 under your belt. 
Let’s look back at what you’ve learned 
in this chapter: 


*C\ass^a^-^ 

氺 Classes 

: t 二一， 

，:二 。—一 …。 

一七 S cs ta\\ \^a\^ s 
* S〆 
九 o — 如 " s . 


氺 


sbrvAt^> rS 0 V、C 如 

， ' 二 : 二 “ 

/\/\d 々 arC 


Pythoh Tools 

+k Barnes av^c widgets 

x, ^'dgets ahd help h> keep 

thc w ， d 3 士 铋 3 也饮 Rouped). 

* dlass ： a hy>^rd that ih^odudes a 

乙 lass dc+ihi*tioh. 


hew 


* 




一 … P 咖 I viable 

object ^ ^ ，S ^ ^ ⑽以 

* Addi "9 Uscl ^" ^ sM ^ a vaHab | c 

mWhS ••七 Mo ^ s ^ ihc 〜 汁⑶七 objedi 
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go forth and program 


Leaving toww... 



It’s been great having you here m Codeville! 

We’re Sad to see you leave, but there’s nothing like taking what you’ve learned 
and putting it to use. You’re just beginning your programming journey and we’ve put you in the 
driving seat. We’re dying to hear how things go, so drop us a line at the Head First Labs web 
site, www.headfirstlabs.com, and let us know how programming is paying off for YOU! 
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appendix r. leftovers 




The Top Ten Things 
參 (we didn’t cover) 





You’ve come a long way. 

But learning how to program is an activity that never stops. The more you code, the more 
you’ll need to learn new ways to do certain things. You’ll need to master new tools and 
new techniques, too. There’s just not enough room in this book to show you everything 
you might possibly need to know. So, here’s our list of the top ten things we didn’t cover 
that you might want to learn more about next. 
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proper python 


# 1 : Poing things "The Pythow Way" 

Throughout this book, we have very stubbornly resisted writing 
code in the most correct Python Way. “That’s not how a Python 
programmer would do it,’’ was a familiar refrain heard from the 
Head First Programming technical reviewers. Without fail, and with the 
greatest of respect to our reviewers, we generally ignored this advice. 


You see, every programming language has its preferred, tried and 
true, agreed, and accepted way of doing certain things, collectively 
known as programming idioms. And Python is no exception. This is, 
of course, a very good thing, because the more programmers 
using a particular language who follow the standard way of doing 
something, the better. Except, that is, when writing a book like this: 
one designed from the get-go to teach programming concepts. 


Holy smokes! I 
can’t believe they did 
it that way... 




There are times when the idiom, although very smart, can be hard 
to understand and even harder to explain. So, when we had a choice 
between showing you how to do something in a generic way over 
showing you how to do it the Python way, we nearly always chose 
the former approach over the latter. This has the effect of making 
some of the code in this book positively repulsive to hardened 
Python programmers, something that is of little concern to us, as 
this book isn’t for them (and they have lots of other books already). 


This book is {oryou\ the reader who wants to learn how to program 
regardless of the programming language chosen. 

Having said all that, if you now want to learn more about The 
Python Way, start by scanning through the booklist and book reviews 
maintained on the main Python website: 


http:/ / wiki.python.org/moin/PythonBooks 

/n 

Yes, that's su^osed 

-to be ^ W o ’. 


严 

Pyihoh 0uv*u. 


lots about Pyi^om -from 
Mark Lute's classic, 

Pyi\)OY\, Ed’rbW’ y \ o>n 

Covers Python I ar^a previous 
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Using Pythow 1 


If you remember way back in the Readme, we stated we were 
using release 3 of Python in this book. Of course, there’s much 
more to Python that just release 3, as the previous version of the 
language, release 2, is still very, very popular. 

And rightly so. Python 2 has been around for nearly a decade 
and has an impressive collection of technologies built around it, 




Content Management System, and the Twisted Networking Libraries (to 
name just a few). 

Despite all the Python 2 goodness out there, we still went with 
release 3 for this book and our reasoning was very simple: better to 
go with the future than settle on the past. The good folks that bring the 
world Python have stated that Python 3 is where all the cool, new 
stuff will happen with the language. Release 2 has entered what’s 
known as bug-fix mode only: if something is found in 2 that is broken, 
it’ll be fixed, but no new features will be added. 

And here’s the good news: there’s not much difference between the 
code you’ve been writing for Python 3 and what you would write 
for release 2, should you find yourself in the position of needing to 
(perhaps as a result of needing to fix some existing Python 2 code or 
working with a technology that’s based on Python 2). 

Here are a few lines of Python 2 code that highlight some of the 
differences: 


is 幻 lied U i h put0 w 





docs. 
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java, c#, et al 


Other programming languages 

When it comes to teaching programming concepts, there’s more 
than enough to cover without trying to cover multiple programming 
languages. 


We like Python and hope over the course of this book that you’ve 
grown to like Python, too. However, if you want to explore or need to 
learn another programming language, there’s lots of help out there. 
Simply going to your favorite search engine and typing in the name of 
your chosen programming language produces a torrent of sites offering 
to provide you with everything you need to know. 


Two modern languages that are important are Java and C#. And 
guess what? If you have to learn these technologies, Head First Labs has 
you covered. 


^ y \ 

6 \ass\ 6 , ^ 




9<>od ; -to 


Having completed this book, you can now pick up either of these books 
and confidently work your way through them. 


Of course, if you find yourself working in a Java or G# programming 
environment and missing Python, don’t despair. Two active projects 
within the Python Community integrate Python with the above 
programming languages and are well worth checking out (search on the 
project name to learn more): 


Rur> Py-tho^ CoAt 
v/’rthm 七 he Java - 
\/i\riual Madhmc. 



lython 


^onPython 
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# 4: Automated testing techniques 


And, no, before you ask, this has nothing to do with program-testing 
robots automatically testing your code for you (which, we agree, 
would be nice). 

Automated testing does have everything to do with trying to make 
sure, as far as possible, that your code is working properly. 

But, how is this possible? 

The truth is, it’s very hard to know for sure that your code is working 
perfectly 100% of the time. Programs and software systems are 
complex beasts. Over time, they grow, and it gets increasingly hard 
to know for sure if they are working quite the way you want them to. 


To help, programmers test their code. When they are done, they 
test, test, then test some more. And just to be sure, they test again. In 
fact, programmers often test to destruction, which refers to attempting 
everything they know to try and break the program and make it 
misbehave. If testing finds a problem, the code is then fixed so that 
whatever it was isn’t a problem anymore. 

To help with the grunt work that testing sometimes is, Python comes 
with a handy built-in module called unittest. This module’s sole 
purpose in life is to allow you to write code that tests your code. Trust us, 
this isn’t as strange as it sounds. The unittest module provides 
a framework within which you can exercise your code to ensure it’s 
working the way you want it to. 

The idea is simple enough: as you write your code, you write a 
little extra bit of code based on unittest to check that your new 
code is working properly. If the test works (that is, it successfully 
demonstrates that your code is OK), you are then in a position to 
automate the testing of your code by reusing your unittest code. 


For more details, check out the description of unittest in your 
favorite Python book or online in the official Python documentation. 


And now that you know about unittest, you have no excuse not 
to use it to test j ⑽ r code. 
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exterminating bugs 


巧 ： debugging 


This is not as disgusting as it sounds. 

Debugging is related to testing. It is the process of dealing with 
errors that aren’t picked up during testing but, instead, blow up in 
your face when you run your code or — worse — blow up in the face 
of your user! 

Tracking down where a problem is can sometimes feel like a bit of 
an art form, but there are some tried and true techniques that can 
make things easier for you. Experience helps a lot. 


The problem is not with 
the hardware; it's with 
your program. Youll have 
to DEBUG your code. 


O 

0 



One of the most important things you can know about when it 
comes to debugging code is a thing called the debugger. This is 
a software tool that can be used by programmers to run code step 
by step or line by line. As the program runs, the debugger lets you 
watch what’s going on and then potentially see when something 
goes wrong. If you can work out where in your code the problem lies, 
it makes it easier to fix, and the debugger is designed to help you do 
just that. 

It is a rare programming technology indeed that comes without 
a debugger. Python’s is called pdb and it can be accessed from 
within IDLE and within the Python Shell. Check the Python online 
documentation for more information on pdb. 


As mentioned at the top of the page: debugging is related to testing. 
Typically, you debug your code after it is up and running and 
(possibly) delivered to your user. You test your code as you write it 
and before you give your program to your users. The idea is that you 


only ever give a user your program when you’re happy it works the 


way you want it to. 


To be honest, though, there are no hard and fast rules here, and a 
lot of programmers blur the line between debugging and testing, 
treating it all as one activity. 
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# 6: Command - liwe execution 

Throughout the IOV 2 chapters of this book, you’ve consistently 
executed your code from within the IDLE programming 
environment. This has been great while developing and working 
on your code, but it’s probably not how you want your users to run 
your programs. It turns out there’s more than one way to do it 
when it comes to running your code. The method available to you 
(and your users) will vary depending on the operating system you’re 
using. 

Your operating system might have a file association already in place 
that allows you to double-click on a Python program and have 
it execute for you. If this is the case, feel free to double-click to 
your heart’s content. If not, here’s how to start Python from the 
command line on the “big 3” operating systems. Let’s assume the 
program you’re running is called cof f ee_pos . py: 


Microsoft Windows XP [Version 5.1.2600] 

(C) Copyright 1985-2001 Microsoft Corp. 

C:\Documents and Settings\hfprog> C:\Python31\python.exe coffee_pos.py 

1. DONUT 

2. LATTE 

3. FILTER 

4. MUFFIN 

5. Quit 

Choose an option :遙 



0 y \ l/Vmdows, 七 he 

iogcthcv- wiih 七 he 
o( -the pV-oj\rarw you 
'to 



File Edit Window Help Mac OS X and Linux 


python3 coffee_pos.py 


1 

2 

3 

4 

5 


DONUT 

LATTE 

FILTER 

MUFFIN 

Quit 


Choose an option : 




X or 
Mat 0^ A ov 
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down with oop 


# 7: Ooops... we could've covered more OOP 


Chapter 10 introduced the important concept of classes, and throughout 
the book we’ve touched on objects in lots of different places. Doing justice 
to all the concepts of object oriented programming (OOP) would easily take 
an entire book all on its own. 


The bit of OOP covered in Chapter 10 relates to the concept of 
encapsulation. This is the process of bundling data with methods into 
prebuilt templates that can be used to create functionally identical objects of a 
certain type. 


Now... if your eyes glazed over reading that last line, don’t worry; you are 
as normal as the rest of us. OOP is full of terminology like this. As well 
as encapsulation, there’s inheritance and polymorphism, too. 

Discussing all the ins and outs of OOP is something that takes a little 
time and it is not something that we are going to try and do on just one 
page! 

That said, OOP really comes into its own when your programs get very 
large and turn into software systems. When systems start to scale 
(get really, really big), the importance of proper design takes center stage, 
and OOP can help here — big time. Again, there’s help from those lovely 


Encapsulation?!? 
Polymorphism?!? 
Inheritance?!? 

Could they not have 
chosen such intimidating 
terms? 


people at Head First Labs. 


O 


TVis book assumes you already 
kr\ow d bi*t about Java ， 
so £.oy\S»dcV" ttedd 

piv-st Java 
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# 8: Algorithms 

There are plenty of great books that believe it’s impossible to learn 
about programming without also learning about algorithms. 

The word “algorithm” is used to describe a precise and established 
way of solving a particular problem in any programming language. 
It’s often useful to think of an algorithm as a recipe. 

In the good ol’ days, it was certainly true that every programmer had 
to have a good grasp of algorithms in order to get anything of any 
worth done. But, luckily for you, this is no longer the case. 

Nowadays, with programming technologies such as Python (and 
Ruby, Perl, Java, and C#)，this is less of an issue because modern 
programming languages just do so much for you. 

For instance, if you need to sort something in Python, you either 
call the sort () method on a object or use the built-in sorted () 
function, and the thing you are working with is duly sorted. You are 
probably less concerned (and rightly so) with how the sort actually 
occurred — that is, with the details of the algorithm used to sort your 
data. Was it the quicksort algorithm or the bubblesort? Maybe it was 
timsort or something else entirely? Maybe you don’t care, because 
calling sort () or using sorted () orders your data in the way you 
desire and frees you to move onto some other problem that needs 
solving. 

You could take the time to write a really cool sort function and learn 
lots about algorithms in the process but, let’s face it, life is far too short. 

If you want to write your own programming language, you’ll need 
to learn lots about algorithms. If all you want to do is use an existing 
programming language (like Python), you can worry less about 
algorithms and more about writing code, which is precisely how it 
should be (in our opinion). 



heavy lifting 


# 9: AdvaM^programmiwg topics 

There are a bunch of advanced programming topics that were never likely to 
make it into a book like this. Here is a list of six such topics (all supported by 
Python 3). 

Threads are a programming technology that allows you to break your 
program into discrete coded chunks that can then be executed in parallel or 
concurrently. Each chunk is known as a thread. Using threads can result in 
some beautiful coding designs, which can make the solving of a certain class 
of problem almost trivial. Under certain circumstances and restrictions, it is 
possible to have threads communicate with each other and share data, which, 
although possible, is hard to get right and can lead to some rather tricky 
and hard-to-track-down bugs. If you think you need threads, approach with 
extreme caution and be prepared to have your brain expanded in ways that you 
never thought possible. 

Recursion is a programming technique that allows you to create a function 
that is capable of calling itself m order to get its work done. There are certain 
types of mathematical problems that are well-suited to a recursive solution, 
but not much else. 

Metaprogramming refers to writing programs that can write other 
programs or manipulate themselves (sounds icky, and it can be). It is not for 
the faint of heart. 

Functional programming (typified by languages such as Lisp) is a 
technique that treats computation as a series of function calls that specify 
what is required of the program, as opposed to a procedural program^ which 
details the steps that are required in order to solve a problem. 

Regular expressions are a technology that allows you to specify 
concisely what it is you are looking for in your data. Having written a 
regular expression (or regex), Python can then go and get it for you. Every 
programmer should know how to take advantage of regexes. The trouble is, 
they look so very strange at first that most coders recoil in disgust. This is a 
pity, as we think regexes are super cool and well-worth learning. 

Unicode is an industry standard that allows you to consistently represent 
and work with text written in most of the world’s languages or “writing 
systems.” If you are working with text originating from somewhere other 
than the place where they speak your language, then you’ll want to know a 
bit about the Unicode character encoding system. 

If you find yourself needing any of this stuff, best to start on the Internet and 
do some background reading on the topic before buying a book with your 
hard-earned cash. The Wikipedia entries for each of these six topics are 
good starting points. 
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# 10: Other IPEs, shells, and text editors 

It might be hard for you to fathom, but there is life beyond IDLE. 
There’s life beyond the Python Shell, too. Both IDLE and the Python 
Shell are great learning tools, but sooner or later, you might find 
yourself wanting more. 

iPython is a bit like the Python Shell on steroids, and a lot of Python 
programmers swear by it. It has a lot of extra features over and 
above those in the normal shell that are designed to make the Python 
programmer’s life easier. It is well-worth looking into. 

When it comes to full-blown programming environments, there 
are many choices. Search the Internet for “Python IDE” to see a 
complete list. A few that come up more than most include: Komodo, 
Eclipse, and Eric. It’s worth taking a look at each, and then 
deciding if one of them (or something else entirely) is just right for 
you. 

IDLE and the Python Shell may satisfy your needs. But, if you are 
looking for more from your programming tool, there’s lots of choices 
out there. 

As for text editors... well, there are lots of choices, too. Some people 
prefer Emacs, while others prefer vi. The Head First Labs advice is to 
try out a few editors before picking the one that best suits your needs. 







Symbols 

: (colon) 

in if/else branches, 22 
in index of string, 43 
in while loops, 29 

{} (curly brackets), creating hashes, 153 

=(equal sign), assignment operator, 4, 35 

==(equal sign, double), equal to operator, 4, 15 

!= (exclamation point, equal sign), not equal to operator, 
30 

0 (parentheses) 

in format strings, 182 
in function definition, 82 


appendO method, arrays, 132, 144 
arguments (parameters), 96-98, 101, 111 

arrays (lists), 130—134, 144, 285 
adding items to, 138 
counting occurrences of values in, 138 
creating, 132， 134 
extending, 132， 138 
index (offset value) for, 132 
methods for, 138 
multi-dimensional arrays, 152 
removing items from, 138 
reversing order of, 138, 140 
searching, 138 
sorting, 136—140, 144 

askokcancel message boxes, 306 


% (percentage symbol), preceding format strings, 180-182 askquestion message boxes, 306 


.(period), in library function request, 69 

+ (plus sign), addition operator, 58 

# (pound sign), preceding comments, 95, 205 

> (right angle bracket), greater than operator, 62, 75 

I ] (square brackets) 

creating arrays, 132, 134 
enclosing index of array, 132 
enclosing index of string, 42 
enclosing key for hash, 153 


askretrycancel message boxes, 306 
askyesnocancel message boxes, 304, 306 
assignment 

of multiple values, 122—124 
of single values, 4, 35 

assignment operator (=), 4, 35 

associative arrays, (see hashes) 

automated testing, 389 


A 

abstraction, 93 
addition operator (+), 58 
algorithms, 393 


B 

Bates, Bert (Head First Java), 388 
Beighley, Lynn (Head First SQL), 170 
bloated code, 81 
books 


this is the index 397 


the index 


Head First G# (Stellman, Greene), 388 
Head First Java (Sierra, Bates), 388 
Head First Object-Oriented Analysis & Design 
(McLaughlin, Pollice, West), 392 
Head First SQL (Beighley), 170 
Learning Python, 4th Edition (Lutz), 386 

brackets, curly ({}), creating hashes, 153, 175 

brackets, square (□) 

creating arrays, 132， 134 
enclosing index of array, 132 
enclosing index of string, 42 
enclosing key for hash, 153 

branches, 14, 15—21，24 

break statement, 255 

ButtonO widget, 255 

connecting code to, 239-244, 245 
creating, 234-236 


c 

G# language 

compared to Python, 9 
learning, 388 

characters, (see strings) 

GheckbuttonO widget, 331—335, 348 

classes, 366, 372—373, 383. (see also methods; objects) 
constructors for, 370—373, 383 
data for, 372 
defining, 367-368 

clockO function, time library, 70 
closeO method, files, 116, 144 
code 

bloated, 81 


command-line execution of, 391 
comments in, 95, 205 
debugging, 390 
duplicating, 80-81 
indents in, 21， 22 
paths in, 13, 20—21 
pseudo-code, 127 
Python practices for, 386 
reusing with functions, 81—82, 351—360 
reusing with modules, 192—199, 200—202, 205-211, 
214 

running from IDLE, 7—8 
saving, 7 
testing, 389 
white space in, 22 

code examples, (see examples) 

coffee examples, (see health club example; Starbuzz Coffee 
example) 

collection variables, (see data structures) 
colon (:) 

in if/else branches, 22 
in index of string, 43 
in while loops, 29 

combo boxes, 248 

command-line execution, 391 

comments, 95, 205 

conditionals, 35 

in branches, 14—15 
in while loops, 29 

constructors (initializer methods), 370-373, 383 

control variables, 278 

controller, 277, 292 

countO method, arrays, 138 

crashes, 296 

curly brackets ({})，creating hashes, 153， 175 
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D 

data entry widgets 

GheckbuttonO widget, 331—335, 348 
EntryO widget, 261-262, 266-267, 269, 292 
model for, 276-278, 285, 292 
OptionMenuO widget, 284—290, 292 
populating dynamically, 288-290, 292 
RadioButtonO widget, 272—273, 275—280, 292 
restricting input to, 271—273 
ScaleO widget, 336—338, 340—345, 348 
TextO widget, 261, 263, 266-267, 269, 292 

datastorage ， 129—130 

data structures, 131 ， 150. (see also arrays; hashes) 
list of, 152 

returning from functions, 164—167 
database, 170-172, 175 
datatypes, converting, 4, 9, 64-65, 75 
date and time functions, 68-73 
daylightO function, time library, 70 
debugging, 390 
decision points, (see branches) 
decodeO method, 49 
def keyword, 82, 111 

delete0 method, data entry widgets, 262, 263, 267, 269 

delivery company example, 258-291 
dynamic depot options for, 283-291 
errors in delivery tracking, handling, 294—310 
GUI for delivery system, 258—268 
user input, controlling, 271-281 

destroyO method, apps, 326, 348 
dialog boxes, 248. (see also message boxes) 
dictionaries, (see hashes) 
directories, reading files in, 378-381 
disk storage, 129 


DJ example, {see mixing software example) 

Don’t Repeat Yourself (DRY), 88 

DoubleVarO variable, 340, 345, 348 

drop down lists, 248. (see also OptionMenuO widget) 

DRY (Don’t Repeat Yourself), 88 


E 

Eclipse IDE, 395 

editors, 5, 395. (see also IDLE) 

Emacs editor, 395 

encapsulation, 392 

endswithO method, strings, 56 

EntryO widget, 261, 269, 292 
creating, 266—267 
methods for, 262 

equal sign (=), assignment operator, 4 

equal sign, double (==), equal to operator, 4, 15 

Eric IDE, 395 

errors, 311. (see also debugging; testing) 
crashes resulting from, 296 
displayed in Shell instead of GUI, 295 
displaying in message boxes, 303—309 
exceptions, 296—300, 311 
TypeError message, 63-64 
ValueError message, 119—120 

event loop, 233—234, 255 
events 

handlers for, 239, 244-245, 255 
from operating system, 319, 348 
from Window Manager, 319-324, 326—327 

examples 

delivery company example, 258-291 
game show example, 216-254 
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guessing game, 3-34 

health club example, 17 8-213 

mixing software example, 314—347, 350—382 

Starbuzz Coffee, 38—74, 78—110 

storeroom example, 294—310 

Surf-A-Thon example, 114—143, 146—174 

except statement, 298-300, 311 

exceptions, 296—300, 311 

exclamation point, equal sign (!=), not equal to operator, 
30 

extendQ method, arrays, 138 


F 

false value, 14 
File menu 

New Window option, 6 
Save option, 7 

files 

handles for, 116 

permissions for, 295 

reading all files in directory, 378-381 

reading from, 116—118, 166 

findO method, strings, 56-58 

floatO function, 64—65, 118 

for loop, 116—118, 154—156 

format strings, 180—184, 186, 214 

formatted data, 179 

FQjNs (fully qualified names), 207—211 ， 213, 214 
Frame0 widget, 364, 373, 383 
fully qualified names (FQNs), 207—211 ， 213, 214 
functional programming, 394 

functions, 82. (see also reusing code; specific functions) 
calling, 82, 84 


creating (defining), 82, 111 

local functions, 356-358, 383 

parameters for, 96-98, 101, 111 

returning data structures from, 164—167, 170—172 

returning values from, 87—88, 111 

with same name in different modules, 206—21 1， 213 

scope of variables in, 104-108 


G 

game show example, 216-254 

answers, displaying in GUI, 246-254 
answers, sound effects for, 216-228 
answers, tallying, 216—218, 226-228 
GUI for, 230-245 

getO method 

data entry widgets, 262, 263, 269, 278 
IntVarO variable, 332, 334 

get_busyO method, channels, 221 

global variables, 108-109, 244 

gmtimeO function, time library, 70 

graphical user interface, (see GUI) 

greater than operator (>) ， 62, 75 

Greene, Jennifer (Head First G#), 388 

grouping widgets, 363—364 

guessing game example, 3-34 

guesses, determining if correct, 3-8 
guesses, higher or lower hints for, 10-25 
multiple guesses, allowing, 26—34 

GUI (graphical user interface), 215, 230-232. (see also 
widgets) 

displaying messages in, 246-254, 303—309, 311 

errors not displayed in, 295 

event loop for, 233-234 

guidelines for, 341 

positioning widgets in, 235-238 
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H 

hash mark (#), preceding comments, 95, 205 

hashes (dictionaries), 152, 175 

adding data to, 153, 156, 161-162 

creating, 153, 175 

iterating through data, 154-156 

keys of, restrictions on, 156 

returning from functions, 164—167, 170—172 

sorting, 158 

Head First G# (Stellman, Greene), 388 

Head First Java (Sierra, Bates), 388 

Head First Object-Oriented Analysis & Design 
(McLaughlin, Pollice, West), 392 

Head First SQL (Beighley), 170 

health club example, 17 8-213 
file format changes, 187—199 
multiple price discounts, 204—213 
price discount, 200—203 
transactions, recording in file, 179-186 

Help menu, 22 

HTML, as strings, 49 



IDE (Integrated Development Environment), 5, 9, 395 
IDLE, 5, 9, 22 

if/else branches, 4, 15-21, 24 
import statement, 49, 69 
importing 

libraries ， 49, 69, 221, 226 
modules, 193, 199, 202, 211， 214 

indents in code, 21, 22 


index (offset value) 
for arrays, 132 
for strings, 42 

indexO method, arrays, 138 
inheritance, 392 

— init_0 method ， 372, 375, 383 

initializer methods (constructors), 370-373, 383 

inputO function, 4, 35, 387 

insertO method 
arrays, 138 

data entry widgets, 262, 263, 269 
intO function, 4, 9, 35 

Integrated Development Environment (IDE), 5, 9, 395 
internationalization, format strings for, 186 
interpreter, 5. (see also IDLE) 

IntVarO variable, 249, 253, 255 
iPython shell, 395 
IronPython project, 388 
itemsO method, hashes, 154, 175 
iteration, (see loops) 



Java language 

compared to Python, 9 
learning, 388 

Jython project, 388 


K 

keysQ method, hashes, 154, 175 
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key-value lists, {see hashes) 
Komodo IDE, 395 



LabelO widget, 248-253, 255 
labels for values, (see variables) 

Learning Python, 4th Edition (Lutz), 386 

libraries, 75. (see also pygame library) 
importing, 49, 69, 221， 226 
third-party libraries (packages), 220, 223 
time library, 68—73 

tkinter library, 233-236, 238, 255, 341 
linked lists, 152 
listdirO function, 380 
lists, (see arrays) 
local functions, 356-358, 383 
local variables, 105, 106, 111 
localtimeO function, time library, 70 
loops, 28, 35 

delaying iterations of, 67—73 
event loop, 233—234, 255 
for loop, 116—118, 154—156 
while loop, 29—33, 61—65 

lowerO method, strings, 56 

Lutz, Mark (Learning Python, 4th Edition), 386 


McLaughlin, Brett D. (Head First Object-Oriented Analy¬ 
sis & Design), 392 

memory, 129—130 

menus, 248 

message boxes, 303—309, 311 
messages 

error messages, (see errors) 
protocol messages, 322 
sending to Twitter, 93—98, 101 

metaprogramming, 394 

methods, 377, 383. (see also specific methods) 
calling, 369-372 
defining, 367-368 

mixing software example, 314—347, 350—382 
multiple tracks, controlling, 350-376 
multiple tracks, reading from directory, 378-382 
toggle for starting and stopping, 328-335 
tracks, starting and stopping, 314-327 
volume control, 336—347 

model for data entry widgets, 276-278, 285, 292 

Model View Controller (MVG), 277 

modular code, 192—199, 200—202, 205-211, 214. (see also 
reusing code) 

module, (see code) 

multi-dimensional arrays, 152 

multiple assignment, 122-124 

MVG (Model View Controller), 277 


M 

mainloopO method, tkinter, 234, 253 
mappings, (see hashes) 


K 

\n, newline in format strings, 182 
New Window option, File menu, 6 
not equal to operator (!=), 30 
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0 

object API, 292 

object-oriented languages, 368, 383 

object-oriented programming (OOP), 392 

objects, 366, 368, 377, 383. (see also classes; methods) 

offset value (index) of strings, 42 

OOP (object-oriented programming), 392 

openO function, 116， 144 

OptionMenuO widget, 284-290, 292 

Options menu, 22 

ordered lists, (see also sorting data) 

P 

packO method, tkinter, 235—236, 238, 264, 269 
packages (third-party libraries), 220, 223 
parameters for functions, 96-98, 101, 111 

parentheses ( 0 ) 

in format strings, 182 
in function definition, 82 

pass statement, 221， 255 
paths in code, 13, 20—21 
pdb debugger, 390 

percentage symbol (%), preceding format strings, 180-182 

period (.), in library function request, 69 

permissions for files, 295 

playO method, sounds, 221 

plus sign (+), addition operator, 58 

point-of-sale (POS) system, 178. (see also health club 
example) 


Pollice, Gary (Head First Object-Oriented Analysis & 
Design), 392 

polymorphism, 392 

popO method, arrays, 138 

POS (point-of-sale) system, 178. (see also health club 
example) 

pound sign (#), preceding comments, 95, 205 

printO function, 4, 35, 387 

program, (see code) 

programming idioms, 386 

protocol events, 321—322 

protocolO method, apps, 322 

pseudo-code, 127 

.py file extension, 7 

pygame library, 219—223, 229, 255 
downloading and installing, 220 
importing, 221， 226 
mixer object for, 221， 226 
platforms supported by, 219 
setting volume, 339 

Python, 9 

books about, 386 
command-line execution of, 391 
compared to Java and G#, 9 
integrated into other languages, 388 
programming idioms for, 386 
systems supporting, 9 
version 2 of, 387 
versions of, 9 

Python IDE. (see IDLE) 

Python Shell, 5 

errors displayed in, 295 
running code in, 8 

.pyw file extension, 237 
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queues, 152 


R 

RadioButtonO widget, 272—273, 275-280, 292 

randintO function, 33, 35 

raw_input() function, 387 

readO method, 49 

reading from files, 116—118 

record, 179. (see also database) 

recursion, 394 

regex, 394 

Regional Surfing Association (RSA) example, 160—167 

regular expressions, 394 

remove0 method, arrays, 138 

repeating pieces of code, (see loops) 

replaceO method, strings, 56 

reserved words, 341, 348 

returnO statement, 87-88, 111 

return values for functions, 87—88, 111 

reusing code, (see also functions) 
with functions, 81—82, 351—360 
with modules, 192—199, 200—202, 205-211, 214 

reverseO method, arrays, 138, 140, 144 
right angle bracket (>)，greater than operator, 62, 75 
RSA (Regional Surfing Association) example, 160—167 
Run Module option, Run menu, 7 



Save option, File menu, 7 

ScaleO widget, 336—338, 340—345, 348 

scope of variables, 104-108, 111 

searching 

arrays, 138 
strings, 52-58 

self variable, 369—370, 377, 383 
setO method 

data entry widgets, 278, 280 
IntVarO variable, 249 
set—volume0 method, pygame, 339 
sets, 152 

sharing code, (see reusing code) 


Shell, {see Python Shell) 
showerror message boxes, 306, 308 
showinfo message boxes, 304, 306 
showwarning message boxes, 306 
Sierra, Kathy (Head First Java), 388 
sleepQ function, time library, 70, 72—73 
slider on a scale, (see ScaleO widget) 
sortO method, arrays, 138, 144 
sortedO function, 158, 175 

sorting data, 128-129 
algorithms for, 393 
in any data structure, 158, 175 
in arrays, 136—140, 144 

sound 

pausing between playing, 221, 223 
playing, 221, 226—227 
pygame library for, 219—223, 229 
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starting and stopping, 316—317 
volume, adjusting, 336—345 
WAV files for, 221, 223 

source code, (see code) 
spaces, (see white space) 

splitO method, strings, 121—124 ， 144, 161-162, 175 
SQL, 170. (see also database) 

square brackets (□) 

creating arrays, 132， 134 
enclosing index of array, 132 
enclosing index of string, 42 
enclosing key for hash, 153 

stack, 104 

stack frame, 105, 111 

Starbuzz Coffee example, 38—74, 78—110 
coffee supplies, maintaining, 78-91 
discount price, finding in HTML, 50—59 
health club discounts, calculating, 204—213 
low price, checking for, 60—74 
order messages, sending to Twitter, 92—110 
price, extracting from HTML, 38—49 

startswithO method, strings, 56 
Stellman, Andrew (Head First C#) 5 388 
storage of data, 129-130 
storeroom example, 294—310 

strings, 41—42, 48, 75 

ending substring, checking, 56 
formatting, 180—184, 186, 214 
lowercase, converting to, 56 
methods for, 55-56 
offset value (index) of, 42 
removing white space from, 56 
replacing substrings in, 56 
searching for substrings in, 52-58 
splitting at spaces, 121-124 
splitting at specified character, 161-162 


starting substring, checking, 56 
substrings of, 43-46, 48, 49 
uppercase, converting to, 54, 56 
web pages as, 49 

StringVarO variable, 278, 280, 292 

strip0 method, strings, 56 

substrings, 48 
length of, 49 

searching for, in strings, 52—58 
specifying, 43-46, 49 

Surf-A-Thon example, 114—143, 146—174 
highest score, calculating, 114-125 
names, matching to scores, 142-143, 146-157 
score data, extracting from database, 169—174 
score data, extracting from formatted file, 160—167 
scores, sorting, 136—141, 158-159 
three highest scores, calculating, 126-135 


T 

tabs in code, 22 

testing, automated, 389 

text, [see strings) 

text boxes, 248 

TextO widget, 261, 269, 292 
creating, 266—267 
methods for, 263 

third-party libraries (packages), 220, 223 
threads, 394 

timeO function, time library, 70 
time library, 68-73 
timezoneO function, time library, 70 
TkQ app, 234, 255 
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tkinter library, 233-236, 238, 255, 341 
toggle switch, (see GheckbuttonO widget) 
transaction file, 179-184, 188-191 
true value, 14 

try statement, 298—300, 311 

TVN example, 169—174. (see also game show example) 
Twitter, sending messages to, 93-98, 101 
TypeError message, 63-64 
types, (see datatypes) 

TJ 

Unicode character encoding system, 394 
unittest module, 389 
upperO method, strings, 54, 56 
uppercase, converting strings to, 54 
urllib.request library, 69 
urlopenO function, 49 

V 

ValueError message, 119—120 
variables, 4, 35 

collections of. (see data structures) 
control variables, 278 
global variables, 108-109, 244 
local variables, 105, 106, 111 
scope of, 104-108, 111 

vi editor, 395 


view, 277. (see also widgets) 

visual toggle, (see GheckbuttonO widget) 

volume, adjusting, 336—345 

W 

wait_finishO function, 221， 223 
WAV files, 221， 223 
web pages, as strings, 49 

West, Dave (Head First Object-Oriented Analysis & 
Design), 392 

while loop, 29-33, 61—65 

white space 
in code, 22 

removing from strings, 56 
specifying in format strings, 182 
splitting strings at, 121-124 

widgets 

ButtonO widget, 234—236, 239—244, 245, 255 

choosing, 341 

compared to objects, 368 

for data entry, (see data entry widgets) 

event loop for, 255 

Frame0 widget, 364, 373, 383 

grouping, 363—364 

LabelO widget, 248-253, 255 

list of, 248 

positioning, 235-238 
Window Manager, 348 
Window Manager events, 319-324, 326-327 
WM—DELETE—WINDOW message, 322 
WM—SAVE—YOURSELF message, 322 
WM—TAKE_FOCUS message, 322 
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